Git.Top

io.github.haocn-opsPublished by GitHub account haocn-opsv0.1.1Updated Oct 24, 2026

Evidence-backed open-source project search, recommendations, alternatives, and comparisons.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Git.Top is a remote MCP server over a knowledge graph of open-source projects, letting an assistant discover, compare, recommend and explain GitHub repositories

What you can do
Discover open-source AI projects by category, deployment target and use case, and browse ecosystem maps and trending projects. Compare project shortlists with decision summaries, ranking signals and tradeoffs. Find alternatives and related projects, and explore relationships such as dependencies, deployments and use cases. Explain Git.Top Score, Agent Score, quality signals, risk flags and evidence for a project. Search structured project knowledge and retrieve per-project records with source metadata.
When to use it
Useful when an assistant needs to shortlist, compare or justify open-source choices, for example picking browser-automation or RAG projects for a given deployment target, or explaining why one repository ranks above another.
Requirements
A remote MCP endpoint at git.top, connected over streamable HTTP; the README suggests the focused /mcp/core profile for a first connection. No account, API key or environment variable is declared for the MCP endpoint. Network access to git.top is required.
Before you install
The server returns third-party project data and scores; treat rankings and recommendations as evidence-backed suggestions, not verified facts. The README also documents admin sync endpoints protected by a SYNC_SECRET and a GITHUB_TOKEN for the operator's own deployment, which are not needed to use the hosted MCP endpoint.

Installation

In SourceWeft

  1. Open Git.Top in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.haocn-ops%2Fgit-top/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "git-top": {
      "type": "http",
      "url": "https://git.top/mcp/core/source/mcp-registry?source=mcp-registry"
    }
  }
}

README

Git.Top

The Knowledge Graph of Open Source.

GitHub provides code. Git.Top provides knowledge.

Git.Top turns unstructured GitHub repository data into structured project knowledge that humans and AI agents can search, compare, recommend, score, and call through REST APIs or MCP tools.

The Cloudflare Worker is the only product surface. It serves the human HTML pages, REST APIs, MCP endpoint, GitHub sync, and D1-backed knowledge data.

Production: git.top

Repository: github.com/haocn-ops/git-top

Connect An Agent

Use the focused MCP profile for the shortest first connection:

sh
codex mcp add git-top --url https://git.top/mcp/coreclaude mcp add --transport http --scope user git-top https://git.top/mcp/core

Then ask your agent:

text
Use Git.Top to recommend three open-source browser-agent projects for Docker, then cite the data source and one caveat for each.

Full setup, client status, and REST alternatives: git.top/connect.

Dated compatibility evidence and the distinction between configuration verification and real-client support: git.top/compatibility.

Registry-ready copy, profiles, privacy boundaries, campaign links, and submission status: git.top/distribution.json. An installable REST-first Agent Skill is available at skills/git-top-project-selection.

What Git.Top Does

  • Discover open-source AI projects by category, deployment target, and use case.
  • Compare projects with decision summaries, ranking signals, and tradeoffs.
  • Find alternatives with similarity signals and comparison-ready shortlists.
  • Explore project relationships across alternatives, related projects, dependencies, deployments, and use cases.
  • Explain Git.Top Score, Agent Score, quality signals, risk flags, and evidence.
  • Serve agent-native REST, OpenAPI, llms.txt, llms-full.txt, and MCP surfaces.

Product Surfaces

  • /discover - browse AI agents, MCP servers, RAG, browser automation, and AI IDE projects.
  • /recommend - turn use cases and constraints into explainable project shortlists.
  • /compare - compare project shortlists.
  • /alternatives and /alternatives/:project - find replacement candidates.
  • /graph/:project - inspect project knowledge graphs.
  • /score/:project - explain project score dimensions.
  • /atlas - explore ecosystem maps.
  • /api/* - consume structured knowledge.
  • /mcp - connect agents through MCP.
  • /mcp/core - connect a focused five-tool MCP profile for first-time use.

Architecture

text
GitHub API  -> Git.Top ETL  -> Cloudflare D1  -> Worker pages, REST APIs, MCP tools, sync jobs, and quality gates

The project intentionally does not ship a separate Next.js app. Keeping Worker-rendered pages, APIs, sync, D1 access, OpenAPI, and MCP in one runtime avoids split product behavior.

Documentation

Development

For maintenance agents, start with AGENTS.md. It summarizes the runtime, high-risk areas, generated data, and validation tiers.

Fast checks:

sh
pnpm docs:validatepnpm check

Agent surface checks:

sh
pnpm api:validatepnpm mcp:validatepnpm eval:explanationspnpm check

Data and local D1 checks:

sh
pnpm db:executepnpm db:seedpnpm db:integration

Release checks:

sh
pnpm validatepnpm release:check

Common development commands:

sh
pnpm installpnpm db:executepnpm db:seedpnpm seed:validatepnpm seed:coveragepnpm seed:candidatespnpm seed:live-check -- --limit 20pnpm seed:live-check -- --offset 20 --limit 20node scripts/run-governance-task.mjs daily-production-healthpnpm knowledge:validatepnpm db:seed-sqlpnpm db:validatepnpm db:integrationpnpm core:validatepnpm api:validatepnpm mcp:validatepnpm eval:qualitypnpm eval:explanationspnpm eval:localpnpm eval:rankingpnpm eval:agent-taskspnpm smoke:prodpnpm release:checkpnpm checkpnpm validatepnpm quality:checkpnpm dev

/api/health reports D1 availability and the current project count. Run pnpm db:execute and pnpm db:seed before local API checks when the D1 state is empty. pnpm db:execute prepares the local D1 schema and backfills optional columns that may be missing from older local databases. seed.sql is generated from hand-authored seed knowledge and generated eval fixtures; run pnpm db:seed-sql after changing those fixtures. pnpm db:integration seeds local D1, starts a temporary local Worker, and validates the D1-backed HTTP API path.

pnpm eval:quality is the CI-safe recommendation and classification regression gate. pnpm eval:explanations checks that agent-facing responses include source metadata, classification evidence, quality signal confidence, recommendation reasons/tradeoffs, health count semantics, and GRP reasoning. pnpm eval:agent-tasks gates complete trust, fallback, pagination, evidence, comparison, change-feed, feedback, multilingual, typo, and alias workflows and writes docs/AGENT_TASK_EVAL.md. pnpm eval:local runs broader generated category and deployment probes across the fixture-backed project set and writes docs/EVAL_LOCAL.md; use it before tuning ranking heuristics, but keep it out of the default validation path. pnpm eval:ranking compares offline ranking strategies in docs/RANKING_EXPERIMENTS.md. Runtime search keeps exact-intent ranking by default; broad scoped discovery can opt into ranking=browse.

pnpm seed:candidates discovers seed expansion candidates from live GitHub organization metadata and writes docs/SEED_CANDIDATES.md. Treat it as a review queue, not an automatic append step; candidates still need live-check and category review before entering data/seed-repositories.json.

pnpm smoke:prod validates the deployed Worker at https://git.top and requires D1-backed responses. Use pnpm smoke:prod -- --base-url http://localhost:8787 for a local or preview Worker, or add --allow-seed only when intentionally checking seed fallback behavior.

pnpm quality:check validates the production /api/quality endpoint at https://git.top by default, requires D1-backed metadata, and uses a default minimum score of 90. Use --base-url, --target, --min-score, or --allow-seed for preview and fallback checks.

Operations and data governance are exposed through /operations, /api/governance/summary, and /api/governance/runs. The Cloudflare Worker cron runs hourly maintenance plus daily, weekly, biweekly, and monthly governance checks, then records results in governance_runs.

pnpm release:check runs the public V1 release gate: local validation, local D1 integration, production quality, and production smoke. Use pnpm release:check -- --skip-prod-smoke only when validating a build before the production deployment exists; it skips production-only checks. Use pnpm release:check -- --base-url <origin> to run the same gate against a Worker preview or local origin.

When updating an existing D1 database, apply SQL files in migrations before deploying code that reads the new columns.

Sync

Git.Top can sync real repository data from the GitHub API into D1.

Required production secrets:

sh
wrangler secret put GITHUB_TOKENwrangler secret put SYNC_SECRET

For local development, copy .dev.vars.example to .dev.vars and fill in real values.

Trigger a protected local or production sync:

sh
curl -X POST http://localhost:8787/api/admin/sync \  -H "authorization: Bearer $SYNC_SECRET" \  -H "content-type: application/json" \  -d '{"limit": 40, "offset": 0, "signal_depth": "lite"}'

Use {"limit":40,"signal_depth":"lite"} for manual catch-up syncs after checking recent /api/sync/status runs. Cron uses a smaller lightweight batch size to stay under Worker subrequest limits, while manual catch-up remains capped at 50.

Run repeated production catch-up rounds:

sh
SYNC_SECRET=... pnpm sync:prod:catchup --rounds 13 --limit 40

Omit offset to use the stored seed cursor. Cron syncs use this cursor and advance through the seed list in bounded batches. Add --refresh-cycle when all seed repositories have been indexed but freshness recovery requires revisiting the full seed cursor despite remaining_count=0.

API

  • GET /api/project/:owner/:name
  • GET /api/health
  • GET /api/quality
  • GET /api/benchmark
  • GET /api/governance/summary
  • GET /api/governance/runs
  • GET /api/sync/status
  • GET /api/schema/agent-card.v1
  • GET /api/schema/project-knowledge.v1
  • GET /api/search
  • GET /api/trending
  • GET /api/category/:name
  • GET /api/recommend
  • GET /api/compare
  • GET /api/alternatives/:owner/:name
  • POST /api/grp/query
  • POST /api/admin/sync
  • POST /api/admin/alternatives
  • POST /api/admin/governance/runs

See git_top_v1.md for the V1 development spec and git_top_grp_v1.md for the GRP v1 reasoning protocol implementation spec.

License

MIT

Source: README.md at commit 070390a

Tools

0
SourceWeft has not read this server's tools yet.

Version history

2
  1. v0.1.1LatestOct 3, 2026
  2. v0.1.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts