isolated-commands-mcp-server MCP Server

isolated-commands-mcp-server MCP Server

site icon
2024.12.27 0
TypeScript笔记管理文本处理开发效率
isolated-commands-mcp-server 是一个基于 TypeScript 的 MCP 服务器,用于在隔离环境中本地运行命令。它实现了一个简单的笔记系统,展示了核心 MCP 概念,包括资源表示、工具创建和提示生成。
View on GitHub

Overview

基本能力

产品定位

isolated-commands-mcp-server 是一个用于在隔离环境中本地运行命令的 MCP 服务器,主要用于笔记管理和文本处理。

核心功能

  • 资源管理
  • 通过 note:// URI 列出和访问笔记
  • 每个笔记包含标题、内容和元数据
  • 简单的纯文本 MIME 类型用于内容访问

  • 工具

  • create_note:创建新的文本笔记

    • 需要标题和内容作为必需参数
    • 将笔记存储在服务器状态中
  • 提示

  • summarize_notes:生成所有存储笔记的摘要
    • 包含所有笔记内容作为嵌入资源
    • 返回用于 LLM 摘要的结构化提示

适用场景

  • 本地笔记管理
  • 文本内容摘要生成
  • MCP 协议的学习和演示

工具列表

  • create_note:创建新的文本笔记
  • summarize_notes:生成所有存储笔记的摘要

常见问题解答

  • 调试困难:由于 MCP 服务器通过 stdio 通信,调试可能具有挑战性。建议使用 MCP Inspector 进行调试。

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

  1. 安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发时自动重建:
npm run watch
  1. 与 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 Inspector 进行调试:

npm run inspector

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。