MCP Server in Node.js

MCP Server in Node.js

site icon
2025.03.23 8
Shell工具集成开发自动化开发效率
MCP Server in Node.js 是一个基于 Model Context Protocol (MCP) 的框架,允许开发者将自定义工具集成到 AI 辅助的开发环境中(如 Cursor AI)。该服务通过暴露工具功能(如数据检索或代码分析),使得基于 LLM 的 IDE 可以按需调用这些工具。本项目演示了一个用 Node.js 构建的 MCP 服务器,提供了两个基本工具:一个是加法工具(add),另一个是环境变量检索工具(getApiKey)。
View on GitHub

Overview

基本能力

产品定位

MCP Server in Node.js 是一个用于 AI 辅助开发环境的工具集成框架,旨在提升开发效率和自动化工作流程。

核心功能

  • MCP 集成:将工具功能暴露给基于 LLM 的 IDE。
  • 加法工具:接受两个数字参数并返回它们的和。
  • 环境变量检索:从配置文件中加载环境变量(如 API_KEY)。
  • 输入验证:使用 Zod 进行模式验证。
  • 标准 I/O 传输:通过 StdioServerTransport 与开发环境集成。

适用场景

  • 在 AI 辅助的 IDE(如 Cursor AI)中集成自定义工具。
  • 自动化开发任务,如代码分析、数据检索等。
  • 提升开发效率,通过工具调用减少手动操作。

工具列表

  1. add:接受两个数字参数并返回它们的和。
  2. getApiKey:从环境变量中检索 API_KEY 并返回。

常见问题解答

  • 如何安装依赖?:确保 Node.js 版本为 20 或更高,然后运行 npm install
  • 如何配置 Cursor AI?:修改 ./cursor/mcp.json 文件,指定 Node.js 路径和服务器脚本路径。
  • 如何调试?:使用自然语言提示(如 add 3 and 5)在 Cursor Composer 中测试工具调用。

使用教程

使用依赖

  • Node.js:版本 20 或更高。 bash # 检查 Node.js 版本 node --version

安装教程

  1. 克隆仓库 bash git clone <repository_url> cd <repository_directory>
  2. 安装依赖
  3. 使用现有 package.jsonbash npm install
  4. 手动安装依赖: bash npm install @modelcontextprotocol/sdk @coinpaprika/api-nodejs-client zod 并在 package.json 中添加: json "type": "module"

调试方式

  1. 配置 Cursor AI
  2. 修改 ./cursor/mcp.json 文件,指定正确的 Node.js 路径和服务器脚本路径。
  3. 运行配置自动化脚本(可选): bash chmod +x ./scripts/update_config.sh ./scripts/update_config.sh
  4. 测试工具调用
  5. 在 Cursor Composer 中使用自然语言提示,如 add 3 and 5what is my API key?

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。