MCP客户端工具

一个Python客户端,用于模型上下文协议(MCP),支持与Claude AI进行交互式聊天会话,并利用任何MCP服务器的工具。

  • by Zachwitte21
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Zachwitte21/MCP-Client

使用说明

MCP 客户端

一个用于模型上下文协议(MCP)的Python客户端,它能够利用任何MCP服务器上的工具,实现与Claude AI的交互式聊天会话。

概述

这个客户端连接到MCP服务器(Python或Node.js版本),并提供一个交互式聊天界面,让Claude能够利用服务器上可用的工具来回答您的问题。它作为Claude的AI能力与MCP服务器功能之间的桥梁。

特点/特性

  • 多语言服务器支持连接到用Python或Node.js编写的MCP服务器
  • 交互式聊天循环用于查询Claude并访问工具的对话界面
  • 自动工具发现自动列出并提供连接服务器上的所有工具
  • 工具执行无缝执行工具调用并将结果返回给Claude进行处理

先决条件

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

安装

使用(以下方法)安装依赖项 紫外线:

uv sync

配置

创建一个 .env 在项目根目录下使用您的Anthropic API密钥创建文件:

ANTHROPIC_API_KEY=your_api_key_here

用法

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

uv run client.py <path_to_server_script>

示例

uv run client.py C:\Users\Zachary\Dev\weather\weather.py

一旦连接成功,您将进入一个交互式聊天会话,在这里您可以向Claude提问。Claude将自动使用MCP服务器提供的工具来回答您的问题。

类型 quit 退出会话。

它是如何运作的

  1. 连接客户端使用stdio传输方式连接到指定的MCP服务器
  2. 工具发现从服务器检索所有可用工具
  3. 聊天循环接收用户查询,并将其与可用工具一起发送给Claude
  4. 工具执行当克劳德决定使用某个工具时,客户端会通过MCP服务器执行它
  5. 回应结果被发送回给Claude,由其生成最终回复

依赖项

  • anthropic - Claude AI API 客户端
  • mcp - 模型上下文协议SDK(软件开发工具包)
  • python-dotenv - 环境变量管理