内容
# github-server MCP Server
一个模型上下文协议(Model Context Protocol)服务器
这是一个基于 TypeScript 的 MCP 服务器,实现了一个简单的笔记系统。它通过提供以下功能来展示核心的 MCP 概念:
- 代表文本笔记的资源,带有 URI 和元数据
- 创建新笔记的工具
- 生成笔记摘要的提示
## 特性
### 资源
- 通过 `note://` URI 列出和访问笔记
- 每个笔记都有标题、内容和元数据
- 纯文本 MIME 类型以便于简单内容访问
### 工具
- `create_note` - 创建新的文本笔记
- 需要标题和内容作为必需参数
- 将笔记存储在服务器状态中
### 提示
- `summarize_notes` - 生成所有存储笔记的摘要
- 包含所有笔记内容作为嵌入资源
- 返回结构化提示以供 LLM(大语言模型)摘要使用
## 开发
安装依赖:
```bash
npm install
```
构建服务器:
```bash
npm run build
```
用于自动重建的开发:
```bash
npm run watch
```
## 安装
要与 Claude Desktop 一起使用,请添加服务器配置:
在 MacOS 上:`~/Library/Application Support/Claude/claude_desktop_config.json`
在 Windows 上:`%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"github-server": {
"command": "/path/to/github-server/build/index.js"
}
}
}
```
### 调试
由于 MCP 服务器通过 stdio 进行通信,调试可能会比较困难。我们建议使用 [MCP Inspector](https://github.com/modelcontextprotocol/inspector),它作为一个包脚本可用:
```bash
npm run inspector
```
Inspector 将提供一个 URL,以便在浏览器中访问调试工具。