Skip to main content

MCP server wrapping the OSSInsight REST API — GitHub repo analytics, collections, trending, search, compare, rankings

Project description

OSSInsight MCP Server

A Model Context Protocol (MCP) server for querying GitHub repository analytics from OSSInsight (by PingCAP). Provides repo metadata, trending repos, curated collections, search, compare, and collection rankings — no API key required.

Features

  • ossinsight_repo — GitHub repo metadata: stars, forks, language, license, description
  • ossinsight_trending — Trending repos by language and timeframe
  • ossinsight_collections — List all 102 curated collections
  • ossinsight_search — Search repos and collections by keyword
  • ossinsight_compare — Side-by-side comparison of two repos
  • ossinsight_ranking — Rank repos in a collection by stars, issues, or PRs

Installation

uv (recommended)

uvx ossinsight-mcp

pip

pip install ossinsight-mcp
ossinsight-mcp

Configuration

Claude Desktop

{
  "mcpServers": {
    "ossinsight-mcp": {
      "command": "uvx",
      "args": ["ossinsight-mcp"]
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "ossinsight-mcp": {
      "command": "uvx",
      "args": ["ossinsight-mcp"]
    }
  }
}

Tools

Tool Description Key Params
ossinsight_repo Repo metadata — stars, forks, language, license owner, repo (required)
ossinsight_trending Trending repos by language/timeframe language, period (past_24h/past_week/past_month/past_3mo)
ossinsight_collections List all curated collections (none)
ossinsight_search Search repos and collections q (required), page, page_size, sort
ossinsight_compare Compare two repos side-by-side repo1, repo2 (required)
ossinsight_ranking Rank repos in a collection collection_id (required), metric, range

Examples

# Get repo metadata
ossinsight_repo({"owner": "grafana", "repo": "grafana"})
# → stars: 76K, forks: 14K, language: TypeScript, license: AGPL-3.0

# What's trending in Rust this month
ossinsight_trending({"language": "rust", "period": "past_month"})

# List all collections
ossinsight_collections({})

# Compare two databases
ossinsight_compare({"repo1": "postgres/postgres", "repo2": "clickhouse/clickhouse"})

# Top repos in the AI/ML collection by stars this year
ossinsight_ranking({"collection_id": 12, "metric": "stars", "range": "year"})

Data Source

Uses the OSSInsight API (/api/mcp).

  • Auth: None required
  • Rate limit: 600 requests per hour per IP
  • Data: GH Archive (all public GitHub events since 2011)

Development

git clone https://github.com/GeniusTechnoMystic/ossinsight-mcp.git
cd ossinsight-mcp
uv sync
uv run ossinsight-mcp

Related Projects

Other OSSInsight MCP servers in the ecosystem:

Project Language Tools Tests Install Differentiator
damonxue/mcp-ossinsight Python 5 None npx / Docker Developer analysis, natural language query, web scraping fallback
gztchan/ossinsight-mcp Python 4 None git clone Stargazer/issue/PR creator demographics, generic request tool
This one (ours) Python 6 28 tests uvx / pip install Collections, search, compare, ranking, PyPI-published

Our differentiators

  • Broadest open-source tool set — 6 tools covering repo metadata, trending, collections, search, compare, and ranking. The only open-source server with dedicated tools for collections, search, and compare.
  • Test coverage — 28 tests with mocked HTTP (respx). No competitor has tests.
  • PyPI publication — install with uvx ossinsight-mcp or pip install ossinsight-mcp. No npm, no Docker, no build step.
  • Ranking flexibilityossinsight_ranking supports stars, issues, or PRs across day/week/month/year ranges.

When to use the alternatives

  • damonxue/mcp-ossinsight — if you need developer contribution analysis, natural language queries, or web scraping for repos with <25 stars.
  • gztchan/ossinsight-mcp — if you need stargazer/issue/PR creator demographics (countries, history) or a generic forward-compatible request tool.

Scope note

None of the open-source OSSInsight MCP servers fully wrap the OSSInsight Public API v1beta. A hosted 18-tool OSSInsight MCP server exists on mcpbundles.com covering issue creator, PR creator, and stargazer demographics (countries, history, orgs) — but it's not open source.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ossinsight_mcp-0.2.1.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ossinsight_mcp-0.2.1-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

Details for the file ossinsight_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: ossinsight_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ossinsight_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 d60a8131a59dcfd725d94dcf4fddad1c5a880bcff9110c963f80fd966dd53cef
MD5 f60b857fe7eaefbc71ed72a639c8c63b
BLAKE2b-256 6e6c2fbcdbfe15f03feba896b80520054b0656282eb517fd072e76f4daba4f0d

See more details on using hashes here.

File details

Details for the file ossinsight_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: ossinsight_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 7.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ossinsight_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c6008155e3de2359bf86b071ed7d3b413b6b8d71555fbdcef6911480d68951ab
MD5 c7c9021e6c7cf0d4051cbd33747a4711
BLAKE2b-256 bb748c07c60bedabc2194a22507714de6ef73195a98bece36cb68b0a1d7fdf9f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page