iggy-mcp-server MCP Server

iggy-mcp-server MCP Server

site icon
2025.04.21 0
JavaScript笔记管理MCP 协议演示其它
iggy-mcp-server 是一个基于 TypeScript 的 MCP(Model Context Protocol)服务器,实现了一个简单的笔记系统。它通过提供资源、工具和提示来展示核心 MCP 概念。主要功能包括创建和管理文本笔记,以及生成笔记摘要。
View on GitHub

Overview

基本能力

产品定位

iggy-mcp-server 是一个基于 MCP 协议的服务器,主要用于演示和实现一个简单的笔记系统,展示 MCP 的核心概念。

核心功能

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

  • 工具

  • create_note:创建新的文本笔记

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

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

适用场景

  • 演示 MCP 协议的基本功能
  • 构建简单的笔记管理系统
  • 用于学习和理解 MCP 协议的实际应用

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

  1. 克隆项目并安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发时使用自动重建:
npm run watch
  1. 配置 Claude Desktop 使用该服务器:
  2. MacOS:编辑 ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Windows:编辑 %APPDATA%/Claude/claude_desktop_config.json

添加以下配置:

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

调试方式

由于 MCP 服务器通过 stdio 通信,调试可能具有挑战性。推荐使用 MCP Inspector

npm run inspector

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

许可证

该项目遵循 None 开源许可条款。