HTTP MCP服务器
一个模型上下文协议(MCP)服务器,通过HTTP和stdio传输提供GitHub存储库信息。此服务器使AI助手和其他MCP客户端能够为任何用户获取GitHub存储库。
🚀 特性
- GitHub仓库获取器:检索任何GitHub用户名的所有存储库
- 双重运输模式:
- HTTP模式:作为web服务器运行以进行远程访问
- stdio模式:在本地运行以进行MCP客户端集成
- 类型安全:使用TypeScript和Zod构建用于模式验证
- 快速集成:支持JSON的现代HTTP服务器
📋 先决条件
- Node.js(v18或更高版本)
- npm或纱线
🔧 安装
- 克隆存储库:```bash
git clone https://github.com/kh-mahmoud/streamable-mcp.git
cd streamable-mcp
2. 安装依赖项:```bash
npm install
- 构建项目:```bash
npm run build
## 🎯 用法
### HTTP模式(Web服务器)
以HTTP模式启动服务器:```bash
npm run server
服务器将于启动 http://localhost:3000 (或中指定的端口 PORT 环境变量)。
API终结点:
- 发布
/mcp-MCP JSON-RPC端点
stdio模式(本地MCP客户端)
对于本地MCP客户端集成:```bash
node build/index.js stdio
### 发展模式
在开发过程中以热重载运行:```bash
npm run server
MCP 检查员
检查MCP服务器:```bash
npm run inspect
## 🛠️ 可用工具
### `get_repos`
获取给定GitHub用户名的所有公共存储库。
**参数:**
- `username` (string):用于获取存储库的GitHub用户名
**退货:**
- 所有存储库及其名称的列表````
## 📁 Project Structure
```bash
http_mcp/
├── src/
│ └── index.ts # Main server implementation
├── build/
│ └── index.js # Compiled JavaScript
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
└── Readme.md # This file````
## 🛠️ 使用的技术
- **[模型上下文协议SDK](https://github.com/modelcontextprotocol/sdk)**:MCP服务器实现
- **[快速](https://expressjs.com/)**:HTTP服务器框架
- **[TypeScript](https://www.typescriptlang.org/)**:类型安全的JavaScript
- **[黄道带](https://zod.dev/)**:架构验证
- **[多伦多证券交易所](https://github.com/esbuild-kit/tsx)**:TypeScript执行
## 📝 脚本
- `npm run build`:将TypeScript编译为JavaScript
- `npm start`:启动HTTP服务器
- `npm run server`:使用热重载启动开发服务器
- `npm run inspect`:使用MCP检查器检查MCP服务器
## 🔌 MCP客户端集成
要将此服务器与MCP客户端一起使用,请在MCP客户端设置中对其进行配置:
**对于stdio模式:**
```json
{
"mcpServers": {
"http_mcp": {
"command": "node",
"args": ["path/to/build/index.js"]
}
}
}```
**对于HTTP模式:**
```bash
npm i mcp-remote```
```bash
"http-mcp": {
"command": "mcp-remote",
"args": [
"http://localhost:3000/mcp" or "your/deployment/link/mcp"
],
"env":{
"NODE_OPTIONS":"--no-deprecation"
}
}
🔗 资源
- 构建MCP服务器(Heroku Builder)
⭐ 如果你觉得这个项目有用,请考虑给它一颗星!
```
