🚀 MCP 服务器基本示例

本项目提供了 MCP 服务器的基本示例，帮助你快速搭建和配置 MCP 服务器，实现与 Claude for Desktop 的集成。

🚀 快速开始

📦 安装指南

1. 安装依赖包

使用 pnpm 安装项目所需的依赖包：

pnpm install

2. 构建项目

安装完成后，进行项目构建：

pnpm build

💻 使用示例

MCP 检查工具

可以使用以下命令启动 MCP 服务器和检查工具：

• 启动服务器：

pnpm start

• 运行检查工具：

pnpm inspect

你可以通过 检查工具 - Model Context Protocol 进一步了解和使用该工具。

Claude for Desktop 配置

下载 Claude for Desktop

你可以从 下载 - Claude 下载 Claude for Desktop。

配置 Claude for Desktop

在 VSCode 中打开配置文件：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

配置文件路径为：/Users/[用户]/Library/Application Support/Claude/claude_desktop_config.json 配置文件内容示例如下：

{
  "mcpServers": {
    "RandomNumber": {
      "command": "node",
      "args": ["/绝对路径到父文件夹/build/index.js"]
    }
  }
}

如果你使用的是 mise，可以通过以下命令获取 node 的路径：

$ mise which node
/Users/[用户]/.local/share/mise/installs/node/22.14.0/bin/node

此时配置文件内容如下：

{
  "mcpServers": {
    "RandomNumber": {
      "command": "/Users/[用户]/.local/share/mise/installs/node/22.14.0/bin/node",
      "args": ["/绝对路径到父文件夹/build/index.js"]
    }
  }
}

更多参考信息：https://github.com/modelcontextprotocol/servers/issues/64#issuecomment-2503152420

📚 详细文档

资源链接

• 示例服务器 - Model Context Protocol
• 官方 Typescript SDK 用于 Model Context Protocol 服务端和客户端
• 使用 TypeScript 实现 MCP 服务器并在 Claude Desktop 上使用的指南
• 如何简单实现一个自定义的 MCP 服务器的方法