velle (P Stryder)

MCPAI代理

提供方 PStryder

AI代理 未标注 会话登录 社区 / 第三方 Claude

Velle是一个MCP服务器,为Claude Code提供自主提示能力,通过Win32控制台API将文本注入终端作为用户输入,实现无需人工干预的自主多轮工作流。

一句话选型结论

按资料字段整理

velle (P Stryder) 属于AI代理类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

自主提示Python本地部署MCP服务器Win32API工作流自动化审计日志

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
velle (P Stryder)当前 2 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方PStryder上游标注的维护方 PStryder
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.1 KB
来自项目仓库与上游目录的原文,未做删改

Velle

拉丁语:“to will”-意志的根源。

Velle是一个MCP服务器,它使Claude Code能够自我提示。它通过Win32控制台API将文本作为用户输入注入终端,实现了无人干预的自主多回合工作流。功能包括自提示链、两步斜线命令自检、可配置转弯限制、冷却强制和审计日志记录。

运作原理

Velle作为Claude Code的MCP服务器子进程运行。当代理人来电时 velle_prompt,服务器将文本作为键盘输入注入父进程的控制台:```
Agent calls velle_prompt("investigate the auth module")
|
v
Velle MCP Server (child process)
|
FreeConsole() -> AttachConsole(parent) -> CreateFile("CONIN$")
|
WriteConsoleInputW(key events) -> 500ms delay -> Enter key
|
v
Claude Code receives text as user input -> Agent gets a new turn


每一轮,代理都会决定下一步做什么,并可以链接另一轮 `velle_prompt` 继续自主。

### Slash命令反思

Slash命令需要两步注入:命令本身,然后是后续提示,以便代理有机会读取输出。```python
velle_prompt(
text="/context",
follow_up="Summarize the context usage above.",
delay_ms=2000,
follow_up_delay_ms=3000
)

代理接收斜线命令输出,如下所示 `` 根据其背景,可以采取行动。

允许的Slash命令

命令 描述
/compact 将对话压缩到自由语境
/context 可视化上下文窗口的使用情况
/usage 显示计划使用限制和费率限制
/status 显示版本、型号、帐户、连接
/stats 可视化每日使用情况、会话历史记录
/todos 显示活动待办事项
/tasks 显示正在运行的后台任务
/bashes 显示正在运行的后台bash命令
/doctor 检查安装状况
/debug 读取会话调试日志
/ide 显示IDE连接状态
/release-notes 查看发行说明

交互式命令(/help, /mcp, /config等等)被阻塞。

工具

velle_prompt

将文本作为用户输入注入Claude Code会话。

参数 类型 默认值 说明
text 字符串 必需的 要注入的文本
delay_ms integer 500 注射前延迟(ms)
follow_up string -- 斜线命令的可选第二次注入
follow_up_delay_ms integer 3000 第一次和第二次注射之间的延迟(ms)
reason string -- 为什么发出此提示(审计跟踪)

velle_status

返回当前会话状态:回合计数、限制、控制台可用性、最近的提示日志和配置文件路径。

安全

  • 转弯限制 --每个会话可配置的最大自我提示数(默认值:20)。代理无法修改此内容;只有用户可以编辑配置文件。
  • 冷却 --提示之间的最小延迟(默认值:1000ms)。防止意外双重火灾。
  • 紧急停止开关 --Ctrl+C可以随时停止代理。
  • 审计跟踪 --每个自我提示都会记录到 velle_audit.jsonl 带有时间戳、文本和原因。

配置

设置从加载 velle.json 在项目根目录中:```json
{
"turn_limit": 20,
"cooldown_ms": 1000,
"budget_usd": 5.00,
"audit_mode": "both"
}


更改需要重新启动MCP服务器(`/mcp` 克劳德密码)。代理没有修改配置的工具,只有用户控制这些值。

## 安装

### 先决条件

- Windows 11(使用Win32控制台API)
- Python 3.10+
- 克劳德代码CLI

### 设置```bash
# Clone the repository
git clone https://github.com/PStryder/velle.git
cd velle

# Create virtual environment and install
uv venv
uv pip install -e .

使用克劳德代码注册

添加到您的Claude Code MCP配置中(~/.claude/claude_mcp_config.json):```json
{
"mcpServers": {
"velle": {
"command": "/path/to/velle/.venv/Scripts/python",
"args": ["-m", "velle.server"],
"cwd": "/path/to/velle"
}
}
}


## 建筑```
src/velle/
__init__.py     # Package version
server.py       # MCP server — tool definitions, session state, audit logging
injector.py     # Win32 console injection — AttachConsole, CONIN$, WriteConsoleInputW

注入器连接到父进程的控制台(因为MCP服务器自己的stdin是MCP传输的管道),打开 CONIN$ 要获取真正的控制台输入缓冲区,请写入关键事件,然后分离。文本字符和Enter键之间有500毫秒的延迟,即使控制台忙于输出,也能确保可靠的提交。

项目结构```

velle/
README.md # This file
pyproject.toml # Python package configuration
velle.json # Runtime configuration (turn limits, cooldown)
claude_mcp_config.json # Example MCP server registration
src/velle/ # Source code
spike/ # Proof-of-concept injection tests
docs/ # Design specification and command reference
SPEC.md # Technical specification
COMMANDS.md # Slash command inventory and access classification
```

词源

来自原始印欧语系 嗯… (“希望”),通过拉丁语 渴望 (“to will”),中世纪拉丁语 volitinem (“意志”)。Velle是自愿的行为——一个选择自己下一步行动的代理人。

许可证

Apache 2.0

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
velle (P Stryder) 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

velle (P Stryder) 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

velle (P Stryder) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

velle (P Stryder) 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

velle (P Stryder) 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

velle (P Stryder) 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 工作流自动化、Python、Claude、审计日志。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。