mikegehard_isolated-commands-mcp-server

🚀 分离命令 - MCP 服务器（isolated - commands - mcp - server）MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器，可在隔离环境中本地运行命令。该服务器生动地展示了核心 MCP 概念，具体表现为：

• 提供带有 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 服务器是通过标准输入输出进行通信的，调试工作可能会有一定难度。我们推荐使用 MCP Inspector，它可以作为包脚本使用：

npm run inspector

运行该命令后，Inspector 会提供一个 URL，通过该 URL 可以在浏览器中访问调试工具。