<p align="center"><img src="logo.png" width="96" alt="SrcLog"></p>

# SrcLog MCP Server

Search and inspect open-source GitHub repositories, curated topics and developer rankings from [SrcLog.com](https://srclog.com) — straight from Claude, ChatGPT, Cursor, VS Code and any other MCP client.

- **Remote, hosted:** `https://srclog.com/mcp` (Streamable HTTP, stateless, plain JSON responses)
- **No auth, no API key, no sign-up**
- **Fair-use limit:** 30 tool calls per minute per IP (protocol messages like `initialize` and `tools/list` are free)
- **Data:** ~450,000 repositories and 435 curated topics, refreshed daily from the public GitHub API

## What you can ask

- "Find self-hosted alternatives to Notion with more than 5k stars"
- "What are the most-starred Rust web frameworks?"
- "Who are the top Python developers in Ukraine?"
- "Show me repositories similar to laravel/framework"
- "Give me the profile and rankings of the `vercel` organization"

## Tools

| Tool | What it does | Arguments |
|---|---|---|
| `search_repos` | Hybrid keyword + semantic search over GitHub repositories, with language, topic and star filters | `query?`, `language?`, `topic?`, `min_stars?`, `sort?` (relevance\|stars\|recent), `page?`, `per_page?` |
| `get_repo` | Details for one repository: stars, forks, language, license, topics, SrcLog score, dates, links | `repo` (e.g. `laravel/framework`) |
| `similar_repos` | Semantically similar repositories — useful for finding alternatives | `repo`, `limit?` |
| `list_topics` | All curated topics (slug, title, description) | — |
| `topic_repos` | Most-starred repositories tagged with a topic | `topic`, `page?`, `per_page?` |
| `top_developers` | Ranking of GitHub developers or organizations by stars, forks, watchers or repos, optionally by language and country | `type?` (developers\|organizations), `language?`, `country?` (ISO code), `sort?`, `page?`, `per_page?` |
| `get_owner` | Profile, totals, ranking positions and top repositories of a GitHub user or organization | `login`, `page?`, `per_page?` |

All tools are read-only.

## Install

### Claude Code

```bash
claude mcp add --transport http srclog https://srclog.com/mcp
```

### Claude.ai, ChatGPT and other apps with custom connectors

Add a custom connector, paste `https://srclog.com/mcp` as the server URL and leave authentication empty.

### Cursor, Windsurf and other `mcpServers` configs

```json
{
  "mcpServers": {
    "srclog": { "url": "https://srclog.com/mcp" }
  }
}
```

### VS Code

```json
{
  "servers": {
    "srclog": { "type": "http", "url": "https://srclog.com/mcp" }
  }
}
```

### Raw JSON-RPC

```bash
curl https://srclog.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_repo","arguments":{"repo":"laravel/framework"}}}'
```

## Rate limits

Each tool call counts against a 30 requests/minute budget per IP, shared with the [SrcLog REST API](https://srclog.com/for-developers). Over the limit, the tool returns an error result (`Rate limit: 30 req/min, retry in N s`) instead of dropping the connection, so assistants can wait and retry.

## Links

- Docs: https://srclog.com/for-developers
- Website: https://srclog.com
- MCP Registry name: `com.srclog/srclog`

## License

This repository (docs and listing metadata) is MIT licensed. Repository data comes from the public GitHub API; the SrcLog score and rankings are SrcLog's own.