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
Metadata
Release files for ossinsight-mcp 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ossinsight_mcp-0.2.1.tar.gz | 10.4 kB | Without provenance | Details for ossinsight_mcp-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ossinsight_mcp-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for ossinsight_mcp-0.2.1-py3-none-any.whl |
Total release size: 18.2 kB
Release files / ossinsight_mcp-0.2.1.tar.gz
| Download URL | ossinsight_mcp-0.2.1.tar.gz |
|---|---|
| Size | 10.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d60a8131a59dcfd725d94dcf4fddad1c5a880bcff9110c963f80fd966dd53cef
|
|
BLAKE2b-256 checksum How to use checksums |
6e6c2fbcdbfe15f03feba896b80520054b0656282eb517fd072e76f4daba4f0d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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}
|
Release files / ossinsight_mcp-0.2.1-py3-none-any.whl
| Download URL | ossinsight_mcp-0.2.1-py3-none-any.whl |
|---|---|
| Size | 7.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c6008155e3de2359bf86b071ed7d3b413b6b8d71555fbdcef6911480d68951ab
|
|
BLAKE2b-256 checksum How to use checksums |
bb748c07c60bedabc2194a22507714de6ef73195a98bece36cb68b0a1d7fdf9f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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}
|
Security for ossinsight-mcp 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.