github-server MCP Server

github-server MCP Server

site icon
2025.01.31 0
JavaScript笔记系统MCP 概念演示开发效率内容生成
github-server MCP Server 是一个基于 TypeScript 的 MCP 服务器,实现了一个简单的笔记系统。它通过提供资源和工具来展示核心 MCP 概念,包括创建和管理文本笔记,以及生成笔记摘要的功能。
View on GitHub

Overview

基本能力

产品定位

github-server MCP Server 是一个基于 TypeScript 的 MCP 服务器,实现了一个简单的笔记系统,用于展示核心 MCP 概念。

核心功能

  • Resources
  • 通过 note:// URI 列出和访问笔记
  • 每个笔记包含标题、内容和元数据
  • 提供纯文本 MIME 类型以便简单访问内容

  • Tools

  • create_note - 创建新的文本笔记

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

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

适用场景

  • 开发人员学习和理解 MCP 概念
  • 需要快速创建和管理文本笔记的场景
  • 需要自动生成笔记摘要的场景

工具列表

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

常见问题解答

  • 调试 MCP 服务器可能具有挑战性,建议使用 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": {
    "github-server": {
      "command": "/path/to/github-server/build/index.js"
    }
  }
}

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

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

许可证

None