mcpField
M
MCP Client

MCP Client

github.com/wintertechforum框架与 SDK386 周前更新

关于 MCP Client

基于 Anthropic MCP 示例的简单客户端实现,支持与 Anthropic API 集成和 Agent 循环。用 Python 编写,可连接工具服务器并执行任务。

主要功能

  1. 01MCP 客户端实现
  2. 02Anthropic API 集成
  3. 03Agent 循环支持
  4. 04工具服务器连接

适用场景

  1. 01与远程工具服务器交互
  2. 02运行 AI Agent 任务流
  3. 03开发 MCP 应用原型

MCP 相关

作为 MCP 客户端,连接并与外部 MCP 服务通信,支持工具调用和 Agent 驱动的工作流。

详细介绍

MCP 客户端

MCP 的客户端实现,集成 Anthropic。

需求

  • Python 3.13 或更高版本
  • pip 或 uv 包管理器

设置说明

  1. 克隆仓库:

    git clone <repository-url>
    cd mcp-client
    
  2. 创建并激活虚拟环境:

    uv venv  # Recommended
    source .venv/bin/activate  # On Unix-like systems
    # Or on Windows:
    # .venv\Scripts\activate
    
    # Alternatively with Python's venv module:
    # python -m venv .venv
    # source .venv/bin/activate  # On Unix-like systems
    # .venv\Scripts\activate  # On Windows
    
  3. 安装依赖:

    uv sync  # Recommended
    # Or alternatively with pip:
    # pip install .
    
  4. 配置环境变量:

    • 在项目根目录创建 .env 文件,内容如下:
      ANTHROPIC_API_KEY=your_api_key_here
      
    • 将 your_api_key_here 替换为您的实际 Anthropic API 密钥
  5. 运行: python client.py weather/weather.py

    如果您有单独的工具服务,将 weather/weather.py 替换为您的服务位置

依赖

  • anthropic (>=0.49.0):Anthropic API 客户端
  • httpx (>=0.28.1):HTTP 客户端
  • mcp[cli] (>=1.3.0):MCP 命令行工具
  • python-dotenv (>=1.0.1):环境变量管理

环境变量

以下环境变量为必需的:

  • ANTHROPIC_API_KEY:您用于身份验证的 Anthropic API 密钥

注意

确保您的 .env 文件安全,切勿将其提交到版本控制。仓库包含的 .gitignore 文件应该已排除 .env 文件。

评论

支持 Markdown

第一次接触 MCP?

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

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