Mcp Server Basic Sample
2025.04.14
0
TypeScriptMCP 服务器示例项目开发效率
mcp-server-basic-sample 是一个基于 Model Context Protocol (MCP) 的示例服务器，主要用于展示如何构建和配置 MCP 服务器。它提供了基本的安装、构建和调试流程，并支持与 Claude for Desktop 集成。
View on GitHub
Overview
基本能力
产品定位
mcp-server-basic-sample 是一个示例性的 MCP 服务器，旨在帮助开发者快速理解和实现 MCP 协议的基本功能。
核心功能
- 安装与构建：提供简单的安装和构建命令，支持通过
pnpm进行依赖管理和项目构建。 - 调试与检查：支持通过
pnpm inspect进行调试和检查。 - 与 Claude for Desktop 集成：可以通过配置文件将 MCP 服务器集成到 Claude for Desktop 中。
适用场景
- 学习 MCP 协议：适合开发者学习如何实现 MCP 服务器的基本功能。
- 快速原型开发：可以用于快速构建和测试 MCP 服务器的原型。
- 与 Claude 集成：适合需要将自定义 MCP 服务器集成到 Claude for Desktop 的场景。
工具列表
- MCP Inspector：用于调试和检查 MCP 服务器的工具。
- Claude for Desktop：支持通过配置文件集成 MCP 服务器的桌面应用。
常见问题解答
- 如何配置 Claude for Desktop 以使用 MCP 服务器？
- 修改
claude_desktop_config.json文件，指定 MCP 服务器的路径和参数。 - 如何使用 MCP Inspector？
- 运行
pnpm inspect命令即可启动 Inspector。
使用教程
使用依赖
- 确保已安装 Node.js 和 pnpm。
安装教程
- 安装依赖：
bash pnpm install - 构建项目：
bash pnpm build
调试方式
- 启动服务器：
bash pnpm start - 使用 Inspector 调试：
bash pnpm inspect
配置 Claude for Desktop
- 打开配置文件：
bash code ~/Library/Application\ Support/Claude/claude_desktop_config.json - 修改配置文件，指定 MCP 服务器的路径和参数。
json { "mcpServers": { "RandomNumber": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/build/index.js"] } } } - 如果使用
mise，可以指定具体的 Node.js 路径：json { "mcpServers": { "RandomNumber": { "command": "/Users/[user]/.local/share/mise/installs/node/22.14.0/bin/node", "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/build/index.js"] } } }