mcpField
M
MCP Client

MCP Client

github.com/alessandrodorazio框架与 SDK185 周前更新

关于 MCP Client

MCP Client 是一个示例客户端,支持连接到 MCP 服务来为 Claude 提供工具能力,支持 Python 和 JavaScript 服务器。

主要功能

  1. 01连接 MCP 服务器
  2. 02检索服务工具
  3. 03执行工具调用
  4. 04交互式命令行界面

适用场景

  1. 01演示 MCP 与 Claude API 的集成
  2. 02为 Claude 扩展工具能力
  3. 03学习 MCP 客户端开发

MCP 相关

该客户端通过检索 MCP 服务器的工具描述,让 Claude 使用这些工具解决用户查询。

详细介绍

MCP 客户端

这是一个 Model Context Protocol (MCP) 客户端,允许你与 MCP 服务交互,使 Claude 能够使用这些服务提供的工具。

前置要求

  • Python 3.11 或更高版本
  • Anthropic API 密钥(在 .env 文件中设置)

设置

  1. 克隆此仓库

  2. 确保已安装所需的依赖:

    pip install anthropic mcp python-dotenv
    

    或使用 uv:

    uv pip install anthropic mcp python-dotenv
    
  3. 在 .env 文件中设置你的 Anthropic API 密钥:

    ANTHROPIC_API_KEY=your_api_key_here
    

使用方法

通过提供 MCP 服务脚本的路径来运行客户端:

python client.py path/to/server_script.py

客户端支持 Python 和 JavaScript MCP 服务:

python client.py path/to/server_script.js

工作原理

  1. 客户端连接到指定的 MCP 服务
  2. 它从服务中检索可用的工具
  3. 当你输入查询时,它会连同工具描述一起发送到 Claude
  4. Claude 决定使用哪些工具
  5. 客户端通过服务执行工具调用
  6. 结果被发送回 Claude 以获得最终响应

功能

  • 交互式命令行界面
  • 支持 Python 和 Node.js MCP 服务
  • 正确的资源管理和错误处理
  • 与 Claude 的工具使用功能无缝集成

故障排除

  • 如果遇到连接问题,请验证服务器路径并确保服务器正在运行
  • 由于初始化,首次响应可能需要长达 30 秒
  • 要获取更详细的日志,请查看服务器输出

资源

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。