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, descriptionossinsight_trending— Trending repos by language and timeframeossinsight_collections— List all 102 curated collectionsossinsight_search— Search repos and collections by keywordossinsight_compare— Side-by-side comparison of two reposossinsight_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-mcporpip install ossinsight-mcp. No npm, no Docker, no build step. - Ranking flexibility —
ossinsight_rankingsupports 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d60a8131a59dcfd725d94dcf4fddad1c5a880bcff9110c963f80fd966dd53cef
|
|
| MD5 |
f60b857fe7eaefbc71ed72a639c8c63b
|
|
| BLAKE2b-256 |
6e6c2fbcdbfe15f03feba896b80520054b0656282eb517fd072e76f4daba4f0d
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c6008155e3de2359bf86b071ed7d3b413b6b8d71555fbdcef6911480d68951ab
|
|
| MD5 |
c7c9021e6c7cf0d4051cbd33747a4711
|
|
| BLAKE2b-256 |
bb748c07c60bedabc2194a22507714de6ef73195a98bece36cb68b0a1d7fdf9f
|