MCP协议服务器

一个高性能的Rust实现的MCP协议服务器,用于通过Claude CLI进行AI辅助编程任务。

  • by jakvbs
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 jakvbs/claude-mcp-rs

使用说明

克劳德mcp rs

MCP(模型上下文协议)服务器的高性能Rust实现,它封装了用于AI辅助编码任务的Claude CLI。

特性

  • MCP协议支持:使用Rust SDK实现官方的模型上下文协议
  • Claude CLI集成:包装Claude CLI,通过MCP启用AI辅助编码
  • 会话管理:支持通过会话ID进行多回合对话
  • 可配置的:CLI参数和超时可通过JSON配置文件配置
  • 异步运行时:基于Tokio构建,实现高效异步I/O

先决条件

  • Rust 1.70+(使用2021版)
  • Claude CLI 已安装并配置
  • Claude Code或其他MCP客户端

安装

选项1:从源代码构建

git clone https://github.com/jakvbs/claude-mcp-rs.git
cd claude-mcp-rs
cargo build --release

然后添加到您的Claude Code MCP配置中:

claude mcp add claude-rs -s user --transport stdio -- /path/to/claude-mcp-rs

选项2:从版本下载

从以下网址下载适用于您平台的二进制文件 发布页面.

建筑

# Debug build
cargo build

# Release build
cargo build --release

跑步

服务器通过stdio传输进行通信:

cargo run

或者在建造之后:

./target/release/claude-mcp-rs

工具使用

服务器提供单一 claude 具有最小参数曲面的工具。大多数Claude CLI标志都是通过配置文件全局配置的。

所需参数

参数 类型 说明
PROMPT string 克劳德的任务指令

可选参数

参数 类型 说明
SESSION_ID string 恢复以前启动的Claude CLI会话。使用精确 SESSION_ID 从早期调用返回的值。如果省略,将创建一个新会话。不要发送空字符串值:启动新会话时,省略 SESSION_ID 完全不传球 \"\".

响应结构

{
  "success": true,
  "SESSION_ID": "uuid-string",
  "message": "Claude's response text",
  "error": null,
  "warnings": null
}

配置

服务器从以下位置加载配置 claude-mcp.config.json 在当前工作目录中,或从通过指定的路径 CLAUDE_MCP_CONFIG_PATH 环境变量。

配置示例:

{
  "additional_args": [
    "--dangerously-skip-permissions"
  ],
  "timeout_secs": 600
}

配置选项

选项 类型 默认值 描述
additional_args string[] [] 传递给每次Claude调用的额外CLI参数
timeout_secs 编号 600 每次执行的最大运行时间(限制为最大3600)

这 additional_args 在核心标志之后附加(--print, --output-format stream-json)在任何之前 --resume 或迅速的争论。

测试

# Run all tests
cargo test

# Run specific test suite
cargo test --test integration_tests

测试覆盖范围:

  • 单元测试:核心功能
  • 集成测试:端到端场景
  • 服务器测试:MCP协议实施

建筑

Claude Code (MCP Client)
    |
stdio transport
    |
MCP Server (main.rs) -> server::claude() tool
    |
claude::run() -> spawns `claude` subprocess
    |
Parses JSON-streamed output line-by-line
    |
Returns ClaudeResult with session_id, agent_messages

看 CLAUDE.md 获取详细的架构文档。

相关项目

贡献

欢迎投稿!看 贡献.md 作为指导方针。

许可证

MIT许可证-请参阅 许可证 了解详情。