my-server MCP Server

my-server MCP Server

site icon
2025.02.21 0
JavaScript笔记管理MCP 协议演示其它
mcp_practice 是一个基于 TypeScript 的 MCP 服务器,实现了一个简单的笔记系统。它通过提供笔记资源、创建笔记的工具以及生成笔记摘要的提示,展示了 MCP 的核心概念。
View on GitHub

Overview

基本能力

产品定位

mcp_practice 是一个基于 TypeScript 的 MCP 服务器,实现了一个简单的笔记系统。它通过提供笔记资源、创建笔记的工具以及生成笔记摘要的提示,展示了 MCP 的核心概念。

核心功能

  1. 资源
  2. 通过 note:// URI 列出和访问笔记
  3. 每个笔记包含标题、内容和元数据
  4. 使用纯文本 MIME 类型以便简单访问内容

  5. 工具

  6. create_note:创建新的文本笔记

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

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

适用场景

  • 个人笔记管理
  • 笔记摘要生成
  • MCP 协议的学习和演示

工具列表

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

常见问题解答

  • 调试 MCP 服务器可能具有挑战性,因为通信是通过 stdio 进行的。建议使用 MCP Inspector 进行调试。

使用教程

使用依赖

安装依赖:

npm install

安装教程

构建服务器:

npm run build

开发时自动重建:

npm run watch

与 Claude Desktop 一起使用,添加服务器配置:

在 MacOS 上:~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上:%APPDATA%/Claude/claude_desktop_config.json

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

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

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

许可证

None