mcp-client-nodejs

MCP Client Node.js 是一个基于 Model Context Protocol 的 Node.js 客户端实现。它允许您的应用通过大语言模型（LLM）与符合 MCP 标准的服务器交互，并自动发现服务器提供的工具。通过配置文件或直接指定服务器脚本路径，您可以将任意 MCP 服务器接入到客户端，并利用 LLM 的“工具调用”能力来执行服务器上的操作并获得结果。核心能力包括自动工具发现、日志记录、以及交互式命令行界面，帮助您在应用中以统一的方式访问多种后端服务。要开始使用，需要准备好一个符合 MCP 的服务器或示例配置，以及一个有效的 OpenAI 风格的 API 提供商密钥。

先决条件:

• Node.js 版本 17+ 已安装
• npm 已安装
• 拥有有效的 OpenAI API 密钥（OPENAI_API_KEY）以及模型提供商相关信息

安装步骤:

1. 克隆仓库（或使用 npm/pipx 安装相应包） git clone https://github.com/ConardLi/mcp-client-nodejs.git cd mcp-client-nodejs

2. 安装依赖 npm install

3. 复制并配置环境变量示例 cp .env.example .env 编辑 .env，填入 OPENAI_API_KEY、MODEL_NAME、BASE_URL 等信息

4. 构建项目（如需编译） npm run build

5. 准备 mcp-servers.json 配置文件，包含需要连接的 MCP 服务器定义 参考示例在 README 中给出的格式，将服务器定义写入 ./mcp-servers.json

6. 运行示例（直接运行默认配置） npm run build node build/index.js default ./mcp-servers.json

如需通过 npx 直接运行，请确保网络可访问并使用 npx mcp-client-nodejs ./mcp-servers.json 以加载服务器配置。

日志系统会将所有重要操作记录在 logs/ 目录下，日志采用 JSON 格式便于搜索分析。常见问题包括：OPENAI_API_KEY 未设置、服务器路径错误、工具执行缺少所需环境变量等。若遇到第一次响应较慢的情况，请耐心等待，通常与服务器初始化和工具执行有关。为避免路径问题，请使用绝对路径，Windows 用户请使用正斜杠或正确转义的反斜杠。确保 .env 文件内容与环境变量一致。