Demo MCP Server

🚀 示例 MCP 服务器 - demo-mcp-server

这是一个基于 TypeScript 的模型上下文协议（MCP）服务器，借助项目管理系统的演示来呈现核心概念。其主要用途是指示 AI 打开项目，AI 会调用 MCP 服务器将项目打开并在本地运行。

🚀 快速开始

此 MCP 服务器主要用于配合 AI 实现项目的打开与运行。若要与 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": []
    }
}

✨ 主要特性

资源

• 可列出并通过 project:// URI 访问项目。
• 每个项目都具备项目名称、路径和元数据。
• 采用纯文本 MIME 类型实现简单内容访问。

工具

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

📦 安装指南

安装依赖

npm install

构建服务器

npm run build

带自动重建的开发

npm run watch

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP 检查器，这是一个作为包脚本可用的工具：

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

检查器将提供一个访问调试工具的浏览器 URL。