OSSInsight MCP 服务器

基于 OSSInsight.io 的 MCP 服务器，提供对 GitHub 个人、组织和仓库的数据分析，以及开源生态系统的深入洞察。

功能特点

• 仓库分析：获取有关 GitHub 仓库的全面数据，包括星标趋势、贡献者活动和代码提交
• 开发者分析：了解开发者的贡献模式、活动历史和影响力
• 组织分析：查看 GitHub 组织的全局视图，包括成员、仓库和整体活动
• 项目比较：并排比较两个仓库的关键指标，发现差异和相似之处
• 项目集合：浏览和探索精选的项目集合，如开源数据库、AI 工具等
• 自然语言查询：访问 OSSInsight 的聊天界面，用自然语言提问 GitHub 数据

工具

1. get_repo_analysis

   • 获取 GitHub 仓库的详细分析
   • 输入:
     • owner_repo (字符串): 仓库名称，格式为 'owner/repo'
     • time_period (可选字符串): 分析的时间范围
   • 返回: 来自 API 和网页的仓库分析数据，以及指向 OSSInsight 页面的链接

2. get_developer_analysis

   • 获取 GitHub 开发者的详细分析
   • 输入:
     • username (字符串): GitHub 用户名
   • 返回: 来自 API 和网页的开发者数据，以及指向 OSSInsight 页面的链接

3. get_collection

   • 获取特定集合的信息和仓库列表
   • 输入:
     • collection_id (字符串): 集合 ID，例如 'open-source-database'
   • 返回: 集合数据以及指向 OSSInsight 集合页面的链接

4. list_collections

   • 列出所有可用的仓库集合
   • 输入:
     • page (可选数字): 页码，从 1 开始
     • per_page (可选数字): 每页结果数量，默认为 20
   • 返回: 集合列表以及指向 OSSInsight 浏览集合页面的链接

5. natural_language_query

   • 直接访问 OSSInsight 的自然语言查询界面
   • 输入:
     • query (字符串): 自然语言查询，例如 'Which repositories gained the most stars in 2023?'
   • 返回: 指向 OSSInsight 聊天界面的直接链接，并预填充查询

实现细节

此 MCP 服务器使用双重方法获取数据：

1. OSSInsight 公共 API (v1) - 直接调用 https://api.ossinsight.io/v1/ 端点
2. 网页抓取 - 当 API 受限或不可用时，回退到抓取 OSSInsight 网页

这种方法确保了对 OSSInsight 功能的最大覆盖，同时尊重公共 API 的速率限制（每个 IP 每小时 600 个请求）。

设置

使用配置

Docker

{
  "mcpServers": { 
    "ossinsight": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/ossinsight"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "ossinsight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ossinsight"
      ]
    }
  }
}

构建

Docker 构建:

docker build -t mcp/ossinsight -f src/ossinsight/Dockerfile .

示例用法

获取仓库分析

// 获取 VSCode 仓库的分析数据
{
  "owner_repo": "microsoft/vscode"
}

比较两个仓库

// 比较 React 和 Vue
{
  "repo1": "facebook/react",
  "repo2": "vuejs/vue"
}

自然语言查询

// 获取使用自然语言查询数据的链接
{
  "query": "哪些数据库项目在 2023 年获得了最多的星标？"
}

许可证

此 MCP 服务器基于 MIT 许可证。这意味着您可以自由使用、修改和分发此软件，但需遵守 MIT 许可证的条款和条件。详情请参阅项目存储库中的 LICENSE 文件。