创建本地MCP服务器教程

创建本地MCP服务器的指南。

准备工作

• Node.js（建议使用v22）
• Claude Desktop或其他MCP客户端

教程

1. 项目创建

npx giget@latest gh:7nohe/local-mcp-server-tutorial my-mcp-server
cd my-mcp-server
npm install
git init
git branch -M main
git add .
git commit -m "Initial commit"

2. TypeScript代码构建与运行

构建并运行以下src/index.ts内容：

#!/usr/bin/env node
async function main() {
  console.error("Hello, world!");
}

main().catch((error) => {
  console.error("Fatal error in main():", error);
  process.exit(1);
});

npm run build
./dist/index.js
# 输出: Hello, world!

[!NOTE] 通过package.json的bin属性设置，node_modules/.bin/下会创建符号链接，允许运行./dist/index.js。

3. 安装所需的库

npm install @modelcontextprotocol/sdk zod

4. 实现MCP服务器

#!/usr/bin/env node
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

// 创建MCP服务器实例
const server = new McpServer({
  name: "my-mcp-server",
  version: "1.0.0",
  capabilities: {
    resources: {},
    tools: {},
  },
});

async function main() {
  const transport = new StdioServerTransport();
  // 资源

  // 返回“Hello, world!”的资源定义
  server.resource(
    "Greeting",
    "greeting://hello",
    (uri, { }) => {
      console.log(uri)
      return {
        contents: [
          {
            uri: uri.href,
            text: "Hello, world!",
          }
        ]
      }
    })

  // 使用ResourceTemplate实现动态资源
  server.resource(
    "Greeting with name",
    new ResourceTemplate("greeting://hello/:name"),
    (uri, params) => {
      return {
        contents: [
          {
            uri: uri.href,
            text: `Hello, ${params.name}!`,
          }
        ]
      }
    })
  // 工具

  // 定义一个计算器工具
  server.tool("calculator", {
    add: (a: number, b: number) => a + b,
    subtract: (a: number, b: number) => a - b,
    multiply: (a: number, b: number) => a * b,
    divide: (a: number, b: number) => a / b,
  });
}

// 启动服务器
main().catch((error) => {
  console.error("Server failed to start:", error);
});

5. 调试

使用Inspector进行调试：

npx @modelcontextprotocol/inspector ./dist/index.js

在浏览器中打开http://127.0.0.1:6274，可以查看定义的资源和工具的响应。

[!NOTE] 为了方便，可以运行npm run watch，这样每次代码变更都会自动重新构建。

接下来，在Claude Desktop中进行验证。从Settings -> Developer -> Edit Config打开claude_desktop_config.json，并将其设置如下：

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "/<项目绝对路径>/my-mcp-server/dist/index.js"
    }
  }
}

保存后重启Claude Desktop。工具按钮中应显示一覧，通过Attach from MCP按钮可以选择资源或Prompt，则表示成功。

6. 包发布

npm login
npm publish

[!NOTE] 通过将package.json的name设置为@your-name/my-mcp-server，可以更清晰地识别自己的包。

[!WARNING] npm包一旦发布就很难删除，因此请谨慎操作。

注意事项：

• 在package.json中将scripts.prepublishOnly设置为构建命令，这样在npm publish时会自动构建。
• 通过设置package.json的bin属性，可以作为CLI运行：

"bin": "./dist/index.js"

• 通过设置package.json的files属性，可以指定发布的文件：

"files": [
  "dist"
]

7. 运行已发布的MCP服务器

在Claude Desktop中进行如下配置：

"my-mcp-server": {
  "command": "npx",
  "args": [
    "@your-name/my-mcp-server@latest"
  ]
}

这样即可通过命令运行发布的MCP服务器。