AI导哈

GitHub仓库信息获取服务

一个提供GitHub仓库信息的HTTP MCP服务器，支持通过HTTP和stdio两种传输模式，适用于AI助手和其他MCP客户端。

  • by kh-mahmoud
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 kh-mahmoud/streamable-mcp

使用说明

HTTP MCP服务器

一个模型上下文协议（MCP）服务器，通过HTTP和stdio传输提供GitHub存储库信息。此服务器使AI助手和其他MCP客户端能够为任何用户获取GitHub存储库。

🚀 特性

  • GitHub仓库获取器：检索任何GitHub用户名的所有存储库
  • 双重运输模式:
    • HTTP模式：作为web服务器运行以进行远程访问
    • stdio模式：在本地运行以进行MCP客户端集成
  • 类型安全：使用TypeScript和Zod构建用于模式验证
  • 快速集成：支持JSON的现代HTTP服务器

📋 先决条件

  • Node.js（v18或更高版本）
  • npm或纱线

🔧 安装

  1. 克隆存储库：
git clone https://github.com/kh-mahmoud/streamable-mcp.git
cd streamable-mcp
  1. 安装依赖项：
npm install
  1. 构建项目：
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 server

MCP 检查员

检查MCP服务器：

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

🛠️ 使用的技术

📝 脚本

  • 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