MCP Client

MCP 客户端

一个用于模型上下文协议（MCP）的 TypeScript 客户端，可实现语言模型与外部 MCP 服务工具/服务之间的通信。

概述

此 MCP 客户端提供了灵活的接口，可连接到各种 MCP 服务，让 OpenAI 的 GPT 和 Anthropic 的 Claude 等语言模型通过标准化协议访问外部工具和服务。该客户端支持多种服务类型，并处理跨平台兼容性。

功能

• 同时连接到多个 MCP 服务
• 支持 OpenAI 和 Anthropic 语言模型
• 跨平台兼容（Windows、macOS、Linux）
• 自动处理特定平台的命令
• 可配置环境变量

前置条件

• Node.js（v16+）
• npm 或 yarn
• TypeScript

安装

1. 克隆仓库：

   git clone https://github.com/kamusis/mcp-client.git
   cd mcp-client
   

2. 安装依赖：

   npm install
   

3. 在项目根目录中创建 .env 文件并填入 API 密钥：

   # LLM (OPENAI or ANTHROPIC)
   LLM=OPENAI
   OPENAI_MODEL=gpt-4o
   ANTHROPIC_MODEL=claude-3-5-sonnet-20241022
   
   # LLM API Key
   ANTHROPIC_API_KEY=your_anthropic_api_key
   OPENAI_API_KEY=your_openai_api_key
   
   # MCP Configuration File Path (optional, defaults to ./mcp_config.json)
   # MCP_CONFIG_PATH=./mcp_config.json
   

4. 在 mcp_config.json 中配置 MCP 服务：

   {
     "mcpServers": {
       "sequential-thinking": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-sequential-thinking"
         ]
       },
       "postgres-full-localhost-dev": {
         "command": "node",
         "args": [
           "/path/to/mcp-postgres-full-access-extended/dist/index.js",
           "postgresql://postgres:[email protected]:5432/postgres"
         ],
         "env": {
           "TRANSACTION_TIMEOUT_MS": "60000",
           "MAX_CONCURRENT_TRANSACTIONS": "20",
           "PG_STATEMENT_TIMEOUT_MS": "30000"
         }
       }
     }
   }
   

构建和运行

1. 构建项目：

   npm run build
   

2. 运行客户端：

   node build/index.js
   

配置

环境变量

• LLM：要使用的语言模型提供商（OPENAI 或 ANTHROPIC）
• OPENAI_MODEL：要使用的 OpenAI 模型（例如，gpt-4o）
• ANTHROPIC_MODEL：要使用的 Anthropic 模型（例如，claude-3-5-sonnet-20241022）
• ANTHROPIC_API_KEY：你的 Anthropic API 密钥
• OPENAI_API_KEY：你的 OpenAI API 密钥
• MCP_CONFIG_PATH：MCP 配置文件的路径（可选，默认为 ./mcp_config.json）

MCP 服务配置

mcp_config.json 文件定义了要连接的 MCP 服务。每个服务条目包含：

• command：运行服务的命令
• args：传递给命令的参数
• env：服务的环境变量（可选）

跨平台兼容性

客户端会自动处理特定平台的差异：

• 在 Windows 上，npx 命令会调整为使用 npx.cmd
• Python 命令会根据平台进行调整（Windows 上使用 python，类 Unix 系统上使用 python3）
• 环境变量会正确传递给子进程

许可证

MIT