Content
<div align="center">
<img src="assets/banner.svg" alt="MCP-Anything" width="100%"/>
<br/>
[](https://github.com/Zaymadkid/mcp-anything/actions)
[](https://github.com/Zaymadkid/mcp-anything)
[](LICENSE)
[](https://modelcontextprotocol.io)
<br/>
**Point your AI at any software. Get a typed MCP server back.**<br/>
*The generator that makes anything MCP-native.*
</div>
<img src="assets/how-it-works.svg" alt="How MCP-Anything Works" width="100%"/>
---
## What It Is
MCP-Anything is a **generator**. You tell your AI agent:
> *"Make me an MCP server for Audacity"*
It reads the `mcp-anything` skill, follows a proven 7-phase methodology, and produces a complete, pip-installable `mcp-anything-audacity` package — with typed FastMCP tools, resources, prompts, 100+ passing tests, and ready-to-paste configs for every IDE.
The [pre-built servers](#-optional-pre-built-servers) (Blender, GIMP, Godot, Unity, etc.) are just examples of what it generates. Install them separately if you want them.
---
<img src="assets/demo-terminal.svg" alt="Generator in action — AI asks questions then builds" width="100%"/>
---
## Quickstart
### 1. Add the skill to OpenCode
```jsonc
// ~/.config/opencode/opencode.jsonc
{
"plugin": [
"mcp-anything@git+https://github.com/Zaymadkid/mcp-anything.git"
]
}
```
Restart OpenCode. The `mcp-anything` skill is now live.
### 2. Ask for a server
```
"Make me an MCP server for Audacity"
"Generate MCP tools for the Ollama REST API"
"Wrap OBS Studio as an MCP server"
"Make my internal Python CLI agent-native via MCP"
```
### 3. Install and use it
```bash
cd audacity/agent-harness
pip install -e .
# Add to your IDE (Claude Desktop, Cursor, etc.)
# python -m mcp_anything.audacity
```
---
## What Every Generated Server Includes
<img src="assets/what-you-get.svg" alt="What every generated server includes" width="100%"/>
---
## How the Generator Works
```
Your prompt → AI reads mcp-anything skill → 7-phase build
│
┌────────────────────────────────────────────┘
↓
Phase 1 Software Analysis → <SOFTWARE>.md SOP
Phase 2 Architecture Design → tools / resources / prompts
Phase 3 Implementation → FastMCP server + core modules
Phase 4 Test Planning → test strategy
Phase 5 Tests → 100+ passing tests
Phase 6 SKILL.md → agent-discoverable skill
Phase 7 Package → pip install mcp-anything-<software>
```
Every generated server has full **typed parameters** (agents know what to pass before calling), **MCP Resources** (read state with zero side effects), **MCP Prompts** (step-by-step workflow guides), and **50-level undo/redo**.
---
## Supported Everywhere
MCP is a universal protocol. Generated servers work in every IDE and agent that supports it.
| Platform | How to use MCP-Anything |
|----------|------------------------|
| **Claude Desktop** | Add to `claude_desktop_config.json` |
| **Claude Code** | Read `HARNESS.md`, prompt agent |
| **OpenCode** | Plugin installed → just ask |
| **Cursor** | Add to `~/.cursor/mcp.json` |
| **Windsurf** | Add to `~/.codeium/windsurf/mcp_config.json` |
| **VS Code + GitHub Copilot** | Add to `.vscode/mcp.json` |
| **VS Code + Cline** | MCP Servers settings panel |
| **VS Code + Continue.dev** | Add to `~/.continue/config.json` |
| **VS Code + Roo Code** | Same as Cline format |
| **VS Code + Augment** | Settings → MCP Servers |
| **JetBrains AI Assistant** | Settings → AI Assistant → MCP |
| **Zed** | `context_servers` in `~/.config/zed/settings.json` |
| **Neovim (avante.nvim)** | `mcp.servers` in `init.lua` |
| **Neovim (codecompanion)** | `tools.mcp.servers` in setup |
| **Emacs (gptel)** | `gptel-mcp-servers` |
| **Amazon Q Developer** | MCP config in Q settings |
| **Sourcegraph Cody** | MCP server config |
| **Raycast AI** | MCP extension settings |
| **ChatGPT (OpenAI)** | MCP connector config |
| **MCPJam** | Native MCP support |
| **Any MCP client** | stdio or SSE transport |
**Auto-installer** detects your IDE and configures it:
```bash
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Zaymadkid/mcp-anything/master/install/install.sh | bash
# Windows PowerShell
iex (iwr https://raw.githubusercontent.com/Zaymadkid/mcp-anything/master/install/install.ps1)
```
Full per-platform instructions with copy-paste configs: **[docs/INSTALL.md](docs/INSTALL.md)**
---
## CLI-Anything Bridge
Want access to [CLI-Anything's 50+ harnesses](https://clianything.cc) through MCP instead of subprocess?
```bash
pip install mcp-anything-clihub
```
```python
cli_search(query="audio") # browse clianything.cc registry
cli_install(name="audacity") # pip install the CLI harness
cli_run("audacity", "project list") # call it via MCP, get JSON back
cli_run("ollama", "model list")
cli_run("blender", "scene new --name MyScene")
```
---
## Optional Pre-built Servers
Examples generated by the methodology. Install only what you need:
```bash
pip install mcp-anything-blender # 3D modeling & rendering
pip install mcp-anything-gimp # Image editing, layers, filters
pip install mcp-anything-browser # Web automation & scraping
pip install mcp-anything-libreoffice # Writer, Calc, Impress, PDF
pip install mcp-anything-obs # Streaming & recording
pip install mcp-anything-inkscape # SVG vector graphics
pip install mcp-anything-godot # Godot game engine
pip install mcp-anything-unity # Unity game engine
pip install mcp-anything-clihub # Bridge to 50+ CLI-Anything tools
```
<details>
<summary>View test results</summary>
```
blender 152 ✅ gimp 164 ✅
browser 127 ✅ libreoffice 150 ✅
obs 106 ✅ inkscape 123 ✅
godot 71 ✅ unity 69 ✅
clihub 107 ✅
─────────────────────────────────────────
TOTAL 1069 ✅ 0 failed
```
</details>
<details>
<summary>Add to your MCP config</summary>
**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"blender": { "command": "python", "args": ["-m", "mcp_anything.blender"] },
"godot": { "command": "python", "args": ["-m", "mcp_anything.godot"] }
}
}
```
**OpenCode** (`~/.config/opencode/opencode.jsonc`):
```jsonc
{
"mcp": {
"blender": { "type": "local", "command": ["python", "-m", "mcp_anything.blender"] }
}
}
```
**Cursor** (`~/.cursor/mcp.json`), **Windsurf**, **VS Code** — same JSON format. See [docs/INSTALL.md](docs/INSTALL.md).
</details>
---
## Contributing
Generate a server, make sure 100+ tests pass, submit a PR.
```bash
git clone https://github.com/Zaymadkid/mcp-anything.git
# Ask your AI: "Read HARNESS.md and generate an MCP server for [software]"
# Then: pytest <software>/agent-harness/ -v
```
See [CONTRIBUTING.md](CONTRIBUTING.md) · [HARNESS.md](HARNESS.md) · [docs/INSTALL.md](docs/INSTALL.md)
---
<div align="center">
<sub>The generator is the product. The pre-built servers are just proof it works.</sub>
</div>
