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以使配置生效。