Simple MCP Server

简易 MCP 服务

一个使用 TypeScript 和 @modelcontextprotocol/sdk 构建的基础 MCP（Model Context Protocol）服务示例。

此服务提供一个简单的 echo 工具，可将收到的任何消息原样返回。

功能

• 使用 TypeScript 构建
• 使用 @modelcontextprotocol/sdk
• 包含一个基础的 echo 工具
• 配置为可发布到 npm
• 通过 stdio 通信

前置条件

• Node.js（建议使用 16 或更高版本）
• npm（通常随 Node.js 一起安装）

安装（作为开发者）

1. 克隆代码库：

   git clone <repository-url>
   cd simple-mcp-server
   

2. 安装依赖：

   npm install
   

3. 构建服务：

   npm run build
   

在本地运行服务

构建完成后，可以使用 Node 直接运行编译后的服务：

node build/index.js

服务将启动，并通过标准输入/输出监听 MCP 通信。你会在终端的标准错误输出中看到类似 "Simple MCP Server running on stdio" 的消息。

与 MCP 客户端搭配使用（例如 Claude Desktop）

若要将此服务与 Claude for Desktop 等 MCP 客户端搭配使用，需要配置客户端以启动此服务。

1. 构建服务： 确保已在服务的项目目录中运行 npm run build。

2. 查找绝对路径： 获取编译后入口文件的绝对路径，即项目目录中的 build/index.js。

   • 在 macOS/Linux 上，可以在 build 目录中使用 pwd，也可以在根目录使用 pwd 后拼接 /build/index.js。
   • 在 Windows 上，可在资源管理器中导航到 build 目录并复制路径，或使用 cd build，然后在命令提示符中运行 cd。

3. 编辑客户端配置： 打开 MCP 客户端的配置文件（例如 Claude Desktop 的 claude_desktop_config.json）。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

4. 添加服务条目： 在 mcpServers 下为你的服务添加条目。将 /ABSOLUTE/PATH/TO/YOUR/PROJECT/simple-mcp-server 替换为你在第 2 步中找到的实际绝对路径。

   {
     "mcpServers": {
       "simple-server": { // Use the name defined in src/index.ts
         "command": "node",
         "args": [
           "/ABSOLUTE/PATH/TO/YOUR/PROJECT/simple-mcp-server/build/index.js"
         ]
       }
       // ... other servers might be listed here
     }
   }
   

5. 重启客户端： 保存配置文件并重启 MCP 客户端应用。

现在，客户端应该可以发现并使用 "simple-server" 及其 echo 工具。

发布到 npm（可选）

1. 确保 package.json 中的信息正确（名称、版本、作者、代码库等）。
2. 确保已登录 npm（npm login）。
3. 运行发布命令：

   npm publish --access public # Use --access public for public packages
   

发布后，如果 package.json 中配置了 bin 条目，用户或许可以使用 npx 运行它，类似于 filesystem 示例。

开发

• 构建： npm run build（将 TypeScript 编译为 build/ 中的 JavaScript）
• 监视： npm run build -- --watch（持续监视变更并重新编译）