AI导哈

模型上下文协议服务器

一个基于Node.js的MCP服务器，提供简单的工具调用功能，适用于AI助手集成。

  • by Mtar786
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 mtar786/mcpserver

使用说明

MCP服务器示例

此存储库包含最小 模型上下文协议（MCP） 用Node.js编写的服务器。服务器公开了两个简单的工具，可以通过MCP标准从AI助手（如Claude Desktop或Cursor）调用。

提供的工具

工具名称 描述 参数 返回值
add 将两个数字相加 a （数字）， b （数字） 包含总和的文本
getTime 以ISO格式返回当前服务器时间 无 带有ISO时间戳的文本

这些工具在 index.js 文件使用 McpServer 类来自官方SDK。您可以通过使用自定义参数和逻辑注册自己的工具来扩展此服务器。

安装

  1. 安装Node.js （建议使用20或更高版本）。

  2. 克隆此存储库并安装依赖项：

    npm install

    这 @modelcontextprotocol/sdk 包发布在npm上。此示例使用版本 1.17.0 如参考 package.json.MCP需要Node.js 18.x或更高版本才能正常运行【36446567226308†L72-L78】。

运行服务器

使用Node运行服务器：

npm start

默认情况下，服务器使用 StdioServerTransport 沟通。这意味着它将从以下位置读取JSON-RPC 2.0消息 stdin 并撰写回复 stdout。Claude Desktop或Cursor等工具将为您管理此通信。

与Claude Desktop连接

要将此服务器连接到Claude Desktop，请在您的 mcp.json 配置文件（通常位于 ~/.claude/ 或 ~/.cursor/ 目录取决于客户端）。示例配置如下：

{
  "mcpServers": {
    "example-server": {
      "command": "/absolute/path/to/node",
      "args": [
        "/absolute/path/to/index.js"
      ]
    }
  }
}

更换 command 带有节点二进制文件绝对路径的路径（例如 which node)并更新 args 指向此项目的路径 index.js 文件。

保存配置后，重新启动Claude Desktop应用程序，在系统提示时授予工具权限，您可以通过编写自然语言指令来调用它们，例如：

“加3和5。” --克劳德会打电话给 add 工具并返回总和。

“现在几点了？” --克劳德会打电话给 getTime 工具并返回时间戳。

参考文献

  • Anthropic的公告【714031847317279†L20-L36】中描述了MCP服务器的概念，并在多个教程【67709559959600„L144-L178】中进行了记录。
  • 有关使用官方SDK定义工具的示例，请参阅 mcp-server-node 项目【966057210205090†L0-L18】。

许可证

这个例子是为了教育目的而提供的。修改和调整它以适应您自己的MCP工作流程。

相关 MCP