HTTP MCP服务器
一个模型上下文协议（MCP）服务器，通过HTTP和stdio传输提供GitHub存储库信息。此服务器使AI助手和其他MCP客户端能够为任何用户获取GitHub存储库。
🚀 特性
- GitHub仓库获取器：检索任何GitHub用户名的所有存储库
- 双重运输模式:
- HTTP模式：作为web服务器运行以进行远程访问 - stdio模式：在本地运行以进行MCP客户端集成
- 类型安全：使用TypeScript和Zod构建用于模式验证
- 快速集成：支持JSON的现代HTTP服务器
📋 先决条件
- Node.js（v18或更高版本）
- npm或纱线
🔧 安装
- 克隆存储库：
git clone https://github.com/kh-mahmoud/streamable-mcp.git
cd streamable-mcp- 安装依赖项：
npm install- 构建项目：
npm run build🎯 用法
HTTP模式（Web服务器）
以HTTP模式启动服务器：
npm run server服务器将于启动 http://localhost:3000 （或中指定的端口 PORT 环境变量）。
API终结点：
- 发布
/mcp-MCP JSON-RPC端点
stdio模式（本地MCP客户端）
对于本地MCP客户端集成：
node build/index.js stdio发展模式
在开发过程中以热重载运行：
npm run serverMCP 检查员
检查MCP服务器：
npm run inspect🛠️ 可用工具
get_repos
获取给定GitHub用户名的所有公共存储库。
参数：
username（string）：用于获取存储库的GitHub用户名
退货：
- 所有存储库及其名称的列表
## 📁 Project Structure
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模式：**
{ "mcpServers": { "http_mcp": { "command": "node", "args": ["path/to/build/index.js"] } } }
**对于HTTP模式：**
npm i mcp-remote
"http-mcp": { "command": "mcp-remote", "args": [ "http://localhost:3000/mcp" or "your/deployment/link/mcp" ], "env":{ "NODE_OPTIONS":"--no-deprecation" } }
______________________________________________________________________
## 🔗 资源
- [构建MCP服务器（Heroku Builder）](https://content.herokubuilder.com/mcp-node/building-an-mcp.html)
⭐ 如果你觉得这个项目有用，请考虑给它一颗星！