Isolated Commands MCP Server

🚀 分離命令 - MCP 服務器

這是一個基於 TypeScript 的 Model Context Protocol（MCP）服務器，可在隔離環境中本地運行命令，還實現了簡單的筆記系統。該服務器通過以下功能，生動展示了核心 MCP 概念：

• 資源：藉助 note:// URI 列出並訪問帶有元數據的文本筆記。
• 工具：創建新筆記，需傳入標題和內容作為必填參數，並將筆記存儲在服務器狀態中。

✨ 主要特性

資源

• 可通過 note:// URI 列出和訪問筆記。
• 每篇筆記都包含標題、內容和元數據。
• 採用簡單的純文本 MIME 類型進行內容訪問。

工具

• create_note：創建新的文本筆記。
  • 要求傳入標題和內容作為必填參數。
  • 將筆記存儲在服務器狀態中。

提示

• summarize_notes：生成所有存儲筆記的摘要。
  • 包含所有筆記內容作為嵌入資源。
  • 返回結構化的提示，供大語言模型（LLM）進行總結。

📦 安裝指南

開發依賴安裝

npm install

服務器構建

npm run build

帶自動重建功能的開發模式

npm run watch

與 Claude Desktop 配合使用的安裝步驟

要與 Claude Desktop 一起使用，需添加服務器配置：

• 在 MacOS 上：配置文件路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json。
• 在 Windows 上：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json。

{
  "mcpServers": {
    "isolated-commands-mcp-server": {
      "command": "/path/to/isolated-commands-mcp-server/build/index.js"
    }
  }
}

📚 詳細文檔

調試說明

由於 MCP 服務器通過標準輸入輸出（stdio）進行通信，調試可能具有一定挑戰性。我們推薦使用 MCP Inspector，它作為包腳本可用：

npm run inspector

Inspector 將提供一個可在瀏覽器中訪問調試工具的 URL。