Metadata-Version: 2.5
Name: mcp-demand-radar
Version: 0.1.0
Summary: Track GitHub demand for MCP servers and find the gaps nobody fills yet.
License-Expression: MIT
License-File: LICENSE
Keywords: cli,github,market-research,mcp
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Description-Content-Type: text/markdown

# mcp-demand-radar

Track which MCP servers GitHub users are asking for, and which of those requests nobody has built yet.

Standard library only, Python 3.11+, no dependencies.

## Install

```bash
pip install mcp-demand-radar
```

The command it installs is `mcp-radar`.

## Try it without a token or network

```bash
mcp-radar scan --demo
mcp-radar gaps --demo
mcp-radar report --demo --out radar-out
```

Demo mode uses fictional offline data.

## Real use

```bash
export GITHUB_TOKEN=...        # optional but recommended (5,000 requests/hour instead of 60)
cp radar.example.toml radar.toml   # then adapt your categories
mcp-radar report
```

`radar.toml` is read from the current directory (or `--config path`). Keep it out of version control; the package only ships a neutral `radar.example.toml`.

## Commands

| Command | What it does |
|---|---|
| `mcp-radar scan` | Popular repositories for each configured category (most starred MCP servers, newcomers…). |
| `mcp-radar demand` | Open GitHub issues asking for an MCP server, ranked by reactions. |
| `mcp-radar gaps` | For each request, counts existing MCP servers with ≥10 stars; score = reactions / (1 + that count). |
| `mcp-radar report` | Runs everything, writes `report.html` and `report.csv`, stores a dated snapshot in `data_dir` and shows star gains since the previous snapshot. |

All commands accept `--config`, `--demo` and `--json` (`report` also `--out`).

## Configuration

See `radar.example.toml`: custom categories (`{days30}` / `{days90}` expand to dates), demand queries, minimum reactions, stopwords used to extract a request's subject.

## Using it from Claude Code / Claude Desktop

This is a CLI, not an MCP server. In Claude Code, just ask: "run `mcp-radar gaps` and summarise the top 5 opportunities". Claude Desktop cannot run shell commands; open `report.html` in a browser instead.

## Development

```bash
pip install -e ".[test]"
pytest        # offline, uses simulated GitHub responses
```

## License

MIT
