AI导哈

MCP协议服务器

一个基于TypeScript和Node.js构建的简单MCP协议服务器，用于在Claude Desktop和其他MCP客户端中暴露工具。

  • by jherr
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jherr/saw-mcp-intro

使用说明

MCP服务器示例

一个使用TypeScript和Node.js构建的简单模型上下文协议（MCP）服务器。此服务器演示了如何创建一个MCP服务器，该服务器公开了用于Claude Desktop和其他MCP客户端的工具。

特性

  • 简单 say_hello 用名字问候某人的工具
  • 使用TypeScript构建类型安全
  • 使用Node.js的官方MCP SDK
  • 用于与MCP客户端通信的STDIO传输

先决条件

  • Node.js（v16或更高版本）
  • npm

安装

安装项目依赖项：

npm install

建筑

构建TypeScript源代码：

npm run build

这将编译TypeScript文件 src/ 到 build/ 并使输出可执行。

运行检查器

构建后，您可以使用MCP检查器测试您的服务器：

npm run inspector

或者直接运行它：

npx @modelcontextprotocol/inspector@latest node build/index.js

检查器提供了一个基于网络的界面，您可以在其中交互式地测试MCP工具。

发展

对于自动重新加载的开发，请使用：

npm run dev

重要：在开发使用STDIO传输的MCP服务器时，始终使用 console.error() 对于日志记录，从不 console.log()写入stdout将损坏JSON-RPC消息并破坏您的服务器。

项目结构

example-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled output (generated)
├── package.json
├── tsconfig.json
└── README.md

其他资源

  • MCP服务器设置指南 -设置MCP STDIO服务器的附加信息和演练，包括项目设置、配置和Claude Desktop集成
  • MCP官方文件 -构建MCP服务器的官方文档（注意：此文档可能不是最新的）

Claude桌面集成

要将此服务器与Claude Desktop一起使用，请将其添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "example_server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/THIS/PROJECT/build/index.js"]
    }
  }
}

备注：使用构建的绝对路径 index.js 文件。更改后，完全退出并重新启动Claude Desktop以使配置生效。

相关 MCP