claude-chat

mcp-server-claude-chat

一个适用于 Anthropic Claude Messages API 的 MCP（模型上下文协议）服务。使用 Rust 构建，提供聊天、视觉、实时网络搜索和模型列表等 MCP 工具，因此任何 MCP 客户端（Claude Desktop、Claude Code 等）都可以将 Claude 作为工具使用。

与本集合中的其他 MCP 服务一样，它通过 stdio 使用 JSON-RPC 2.0 通信。从结构上看，它与 mcp-server-grok-chat / mcp-server-gpt-chat 类似，并根据 Anthropic API 的形式进行了调整。

订阅与 API 额度

此服务使用带 API 密钥的 Anthropic API（API 额度）。这是通过第三方工具调用 Claude 唯一受支持且符合条款的方式。

Claude Pro/Max 订阅（为 Claude Code 和 Claude 应用提供支持的订阅）不能用于此处：此类身份验证仅许可用于 Anthropic 自有的第一方客户端，通过自定义服务转发会违反 Anthropic 消费者条款，也就是你提出的“在其他服务中使用价值 200 美元的 Claude”问题。因此，请使用 API 密钥。（如果你运行的是兼容 Anthropic 的网关，可以将 base_url 指向该网关，详见配置。）

工具

工具	描述
chat	向 Claude 发送消息。支持多轮历史记录、系统提示词、模型选择，以及通过 thinking_budget 启用的扩展思考。
chat_with_vision	根据图片 URL 和文本提示词分析图片。
chat_with_search	使用实时网络搜索进行聊天——Claude 在服务端搜索，并提供带引用来源的回答。
list_models	列出可用的 Claude 模型及其 ID（缓存 5 分钟）。

注意：Anthropic 没有嵌入 API 端点（他们推荐使用 Voyage AI），因此与 grok/gpt 服务不同，这里没有 embedding 工具。

chat

名称	类型	必填	描述
prompt	string	是	要发送的用户消息
system_prompt	string	否	用于设置上下文/行为的系统提示词
messages	string	否	以 JSON 数组形式提供的对话历史记录，包含 {role, content} 对象（角色仅限 user/assistant——系统指令请使用 system_prompt）
model	string	否	模型 ID（默认：服务默认模型 claude-opus-4-8）。调用 list_models 获取列表。
temperature	float	否	采样温度（0.0–1.0）。设置 thinking_budget 时会忽略此项。
max_tokens	integer	否	要生成的最大 token 数（默认为服务默认值）
thinking_budget	integer	否	启用扩展思考并设置 token 预算（最小值为 1024）。推理内容会在 [thinking] 块中返回；max_tokens 会自动调高至超过该预算。

chat_with_vision

名称	类型	必填	描述
prompt	string	是	描述要分析内容的文本提示词
image_url	string	是	图片 URL（必须以 http:// 或 https:// 开头）
model	string	否	支持视觉的模型 ID（默认：服务默认模型）
temperature	float	否	采样温度（0.0–1.0）
max_tokens	integer	否	要生成的最大 token 数

chat_with_search

名称	类型	必填	描述
prompt	string	是	用户消息
system_prompt	string	否	系统提示词
model	string	否	模型 ID（默认：服务默认模型）
temperature	float	否	采样温度（0.0–1.0）
max_tokens	integer	否	要生成的最大 token 数
max_uses	integer	否	Claude 可针对本次请求执行的最大网络搜索次数（默认：5）

网络搜索由 Anthropic 收费：每 1,000 次搜索 10 美元，此外还需支付 token 费用；组织管理员必须在 Claude Console 中启用网络搜索。

list_models

无需参数。结果缓存 5 分钟。

前置条件

• Rust（edition 2024）
• Anthropic API 密钥，可从 console.anthropic.com 获取

设置

mkdir -p ~/.config/mcp-server-claude-chat
cp config.toml.example ~/.config/mcp-server-claude-chat/config.toml
# then edit it and set api_key

配置（~/.config/mcp-server-claude-chat/config.toml）：

api_key = "sk-ant-..."

# Optional:
# base_url = "https://api.anthropic.com/v1"   # or a compatible gateway
# default_model = "claude-opus-4-8"
# default_max_tokens = 4096

如果配置缺失或 api_key 为空，服务会在启动时立即失败。

构建

cargo build --release   # produces target/release/claude-chat
cargo build             # debug build
cargo run               # run in dev mode
RUST_LOG=debug cargo run
cargo test              # unit tests (response formatting, validation, message building)

MCP 配置

Claude Desktop（~/.config/Claude/claude_desktop_config.json）或任何 MCP 客户端：

{
  "mcpServers": {
    "claude-chat": {
      "command": "/media/codechap/4TB/develop/mcps/mcp-server-claude-chat/target/release/claude-chat"
    }
  }
}

Claude Code：

claude mcp add claude-chat -- /media/codechap/4TB/develop/mcps/mcp-server-claude-chat/target/release/claude-chat

项目结构

src/
  main.rs    - entry point, config loading, stdio transport setup
  server.rs  - MCP tool definitions (chat, chat_with_vision, chat_with_search, list_models)
  api.rs     - Anthropic HTTP client, Messages/Models types, response formatter
  params.rs  - tool parameter types with serde + JSON Schema derives
  config.rs  - TOML config loading

许可证

MIT