demo-mcp-server MCP 服务器

一个模型上下文协议服务器

一个基于 TypeScript 的 MCP 服务器，通过一个项目管理系统演示核心概念。主要组成部分：

资源：通过 URI 和分层路径查询项目 工具：以编程方式创建和打开项目

目标：告诉 AI 打开项目，AI 将调用 MCP 服务器来打开项目并在本地运行它

特性

资源

• 通过 project:// URI 列出和访问项目
• 每个项目都有一个项目名称、路径和元数据
• 纯文本 MIME 类型，用于简单的内容访问

工具

• create_project - 创建新的文本项目
  • 接受标题和内容作为必需参数
  • 将项目存储在服务器状态中
• open_project - 打开项目

开发

• 安装依赖项：

npm install

• 构建服务器：

npm run build

• 对于具有自动重建功能的开发：

npm run watch

• 调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector，它作为一个包脚本提供：

npx @modelcontextprotocol/inspector node .../demo-mcp-server/build/index.js

Inspector 将提供一个 URL，用于访问浏览器中的调试工具。

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
    "demo-mcp-service": {
      "command": "/usr/local/bin/node",
      "args": [
        ".../demo-mcp-server/build/index.js"
      ],
      "disabled": false,
      "autoApprove": []
    }
}