内容
# 使用模型上下文协议的GitHub代码浏览器
该项目演示了如何实现模型上下文协议(Model Context Protocol,MCP)来创建一个GitHub代码搜索工具,可供AI助手使用。
## 什么是模型上下文协议?
模型上下文协议是一种标准化的方式,用于AI模型与外部工具和服务的交互。它定义了:
1. 如何向AI模型描述函数
2. AI模型如何决定调用哪些函数
3. 参数的结构和验证方式
4. 如何以一致的格式返回结果
## 特性
- 在GitHub仓库中搜索代码
- 查看仓库中的文件内容
- 搜索GitHub仓库
- 函数发现端点
- AI助手模拟接口
## 安装
1. 克隆此仓库
2. 安装依赖:
```bash
npm install
```
3. 可选:设置GitHub API令牌为环境变量`GH_TOKEN`以获得更高的速率限制
## 使用
1. 启动服务器:
```bash
npm start
```
或者用于开发并自动重载:
```bash
npm run dev
```
2. 打开浏览器并导航到 http://localhost:3000
3. 点击“加载可用函数”以查看API功能
4. 在输入框中输入查询并按Enter键以模拟AI对话
## API端点
- `GET /api/mcp/functions` - 列出所有可用函数
- `POST /api/mcp` - 使用参数调用函数
## 实现细节
该应用程序由以下部分组成:
- 一个Node.js/Express后端,封装了GitHub API
- 一个浏览器客户端,使用API模拟AI助手
- 与JSON Schema兼容的MCP函数定义