
MCP Server for Node.js API Documentation

2025.04.20
0
JavaScriptNode.js API文档开发工具开发效率
该项目实现了一个Model Context Protocol (MCP)服务器,提供对官方Node.js API文档的访问。它从`nodejs.org`获取文档,并通过MCP工具暴露这些文档。
View on GitHub
Overview
基本能力
产品定位
该MCP服务器主要用于提供Node.js API文档的访问和查询服务,旨在帮助开发者更高效地查找和使用Node.js的API文档。
核心功能
- 获取最新的Node.js API文档。
- 提供MCP工具来查询特定模块、类或方法的文档。
- 提供搜索工具(
node-search
)来查找模块或列出所有可用模块及其方法。 - 提供列表工具(
node-list
)来获取所有可用模块的摘要。 - 使用
pino
将活动和错误日志记录到/tmp/mcp-server-nodejs-docs.log
。
适用场景
- 开发者在编写Node.js代码时需要快速查找API文档。
- 团队协作中需要统一访问和查询Node.js API文档。
- 开发者需要自动化工具来辅助查询和搜索Node.js API文档。
工具列表
node-search
:用于查找模块或列出所有可用模块及其方法。node-list
:用于获取所有可用模块的摘要。
常见问题解答
- 如何调试服务器?
服务器日志记录在
/tmp/mcp-server-nodejs-docs.log
,可以使用tail -f /tmp/mcp-server-nodejs-docs.log
命令实时查看日志。 - 如何测试服务器?
可以使用内置的
debug
脚本或通过npx -y @modelcontextprotocol/inspector node index.js
命令进行测试。
使用教程
使用依赖
- 安装Node.js和npm:确保系统中已安装Node.js和npm。
安装教程
- 克隆仓库(如果适用):
bash git clone <repository_url> cd <repository_directory>
- 安装依赖:
bash npm install
启动服务器
运行以下命令启动MCP服务器:
npm run start
调试方式
- 启用调试日志:
bash node index.js --debug
- 查看日志:
bash tail -f /tmp/mcp-server-nodejs-docs.log
- 测试服务器:
bash npm run debug
或bash npx -y @modelcontextprotocol/inspector node index.js
连接MCP客户端
该服务器通过标准输入/输出(stdio)进行通信。要将其连接到MCP客户端(如Cursor或Qodo AI),需要配置客户端以使用其命令启动服务器。
示例配置(概念性):
- 名称:例如“Node.js API Documentation”。
- 命令:执行服务器的命令。确保提供
node
和index.js
文件的绝对路径,或确保node
在客户端的PATH环境变量中可访问。bash /path/to/your/node /path/to/your/project/index.js
使用Cursor的示例:
- 转到
Settings
->Cursor Settings
->MCP Servers
。 - 点击
Add Server
。 - 输入名称(例如“NodeJS API Documentation”)。
- 在
Command
字段中输入完整命令,例如:/Users/youruser/.nvm/versions/node/v20.11.1/bin/node /Users/youruser/projects/mcp-server-nodejs-docs/index.js
(替换为实际路径)。 - 保存服务器配置。
- 现在可以在聊天提示中使用
@NodeJS API Documentation
标签(或您选择的名称)。