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。