项目简介
server-anthropic 是一个基于 Model Context Protocol (MCP) 构建的服务器,它充当 Anthropic AI 模型的接口,使得 MCP 客户端(如 Claude Desktop)能够以标准化的方式与 Anthropic 的 Claude 模型进行交互。该服务器简化了与 Anthropic API 的集成过程,并提供了安全可靠的访问控制和会话管理。
主要功能点
- 模型列表查询: 允许客户端获取 Anthropic 提供的所有可用 AI 模型及其详细信息。
- 消息发送: 支持客户端向指定的 Anthropic 模型发送消息,并接收模型的回复。
- 安全 API 密钥管理: 通过环境变量安全地管理 Anthropic API 密钥,无需硬编码在代码中。
- 工作区隔离: 支持通过工作区 ID 隔离不同用途的 API 调用,便于资源管理和成本控制。
- 详细错误处理: 提供全面的错误处理机制,帮助开发者快速定位和解决问题。
- 实验性上下文窗口管理: 探索通过分布式处理扩展对话上下文窗口的可能性。
安装步骤
- 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。你可以从 nodejs.org 下载并安装。
- 安装 server-anthropic: 打开终端或命令提示符,运行以下命令全局安装 'server-anthropic':
npm install -g server-anthropic
服务器配置
为了让 MCP 客户端(例如 Claude Desktop)连接到 'server-anthropic' 服务器,你需要在客户端的配置文件中添加服务器配置信息。以下是 Claude Desktop 客户端的 'claude_desktop_config.json' 配置文件示例:
{ "mcpServers": { "anthropic": { // 服务器名称,可以自定义 "command": "server-anthropic", // 启动服务器的命令,这里直接使用安装后添加到全局环境的 server-anthropic 命令 "args": [], // 启动命令的参数,这里不需要参数 "env": { "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY", // 你的 Anthropic API 密钥,请替换为你的实际密钥 "ANTHROPIC_WORKSPACE_ID": "YOUR_WORKSPACE_ID" // 可选:你的 Anthropic 工作区 ID,如果需要工作区隔离,请设置此项 } } } }
配置参数说明:
- 'server name': 'anthropic' - 服务器的名称,在客户端配置中用于标识不同的 MCP 服务器连接。你可以自定义名称。
- 'command': 'server-anthropic' - 启动 'server-anthropic' MCP 服务器的命令。全局安装后,可以直接使用 'server-anthropic' 命令。
- 'args': '[]' - 启动命令的参数。此服务器实现不需要额外的启动参数,因此设置为空数组。
- 'env': 环境变量配置。
- 'ANTHROPIC_API_KEY': 必填。你的 Anthropic API 密钥。请务必替换 '"YOUR_ANTHROPIC_API_KEY"' 为你在 Anthropic 官网 获取的 API 密钥。
- 'ANTHROPIC_WORKSPACE_ID': 可选。你的 Anthropic 工作区 ID。如果需要使用 Anthropic 的工作区功能进行资源隔离和管理,请设置此项。否则可以忽略。
重要提示: 请将 '"YOUR_ANTHROPIC_API_KEY"' 替换为你自己的 Anthropic API 密钥。不要 将真实的 API 密钥硬编码到配置文件或代码中,使用环境变量是最安全的方式。
基本使用方法
-
启动 MCP 服务器: 'server-anthropic' 服务器在客户端(如 Claude Desktop)启动时会自动运行,无需手动启动。
-
在 MCP 客户端中使用: 配置完成后,在你的 MCP 客户端中选择配置的服务器名称(例如 'anthropic'),即可使用 'list_models' 和 'send_message' 工具与 Anthropic 的 Claude 模型进行交互。
例如,在 Claude Desktop 中,你可以:
- 使用 'list_models' 工具查询可用的 Anthropic 模型列表。
- 使用 'send_message' 工具向指定的模型发送消息,进行对话或完成任务。
具体的工具调用方法和参数,请参考客户端软件的使用说明。'server-anthropic' 提供的工具及其参数定义在上面的 'Tool Reference' 章节中已经详细列出。客户端会根据这些定义生成用户界面或提供相应的调用接口。
信息
分类
AI与计算