Metadata-Version: 2.4
Name: harness-mcp
Version: 0.1.1
Summary: Add high-quality MCP servers to any AI harness — opencode, claude code, cursor, and more
Project-URL: Homepage, https://github.com/suvenkatesh97/harness-mcp
Project-URL: Repository, https://github.com/suvenkatesh97/harness-mcp
Author-email: Sunny <suvenkatesh97@users.noreply.github.com>
License: MIT
License-File: LICENSE
Keywords: ai,claude,cursor,harness,mcp,opencode
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: click>=8
Provides-Extra: dev
Requires-Dist: pytest-cov>=6; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: pyyaml>=6; extra == 'dev'
Requires-Dist: questionary>=2; extra == 'dev'
Requires-Dist: ruff>=0.9; extra == 'dev'
Provides-Extra: interactive
Requires-Dist: pyyaml>=6; extra == 'interactive'
Requires-Dist: questionary>=2; extra == 'interactive'
Provides-Extra: yaml
Requires-Dist: pyyaml>=6; extra == 'yaml'
Description-Content-Type: text/markdown

# harness-mcp

Add high-quality MCP servers to any AI harness. Start with OpenCode, extend to Claude Code, Cursor, and more.

## Install

```bash
# Python (pip)
pip install harness-mcp

# Node.js (npm) — auto-installs Python deps
npm install -g harness-mcp

# Node.js (npx) — no install
npx harness-mcp list

# Single binary (no Python needed)
# Download from: https://github.com/suvenkatesh97/harness-mcp/releases
```

## Quick Start

```bash
# See what's available
harness-mcp list

# Add a server
harness-mcp add github

# Add multiple
harness-mcp add github playwright brave-search

# Add all with a tag
harness-mcp add --tag browser

# See what's configured
harness-mcp status

# Remove a server
harness-mcp remove github
```

## Harness Support

| Harness | Status |
|---------|--------|
| OpenCode | Supported |
| Claude Code | Coming soon |
| Cursor | Coming soon |

## Interactive Mode

```bash
pip install harness-mcp[interactive]
harness-mcp init
```

## Commands

| Command | Description |
|---------|-------------|
| `list` | Browse the MCP server catalog |
| `add <names...>` | Add servers by name or tag |
| `remove <names...>` | Remove servers from config |
| `status` | Show configured MCP servers |
| `search <query>` | Search the catalog |
| `init` | Interactive selection wizard |

## Global Flags

- `--harness` - Target harness (opencode, claude, cursor). Auto-detected.
- `--scope` - `project` (default) or `global`
- `--cwd` - Working directory for project scope
- `--dry-run` - Preview changes without writing

## Custom Catalog Entries

Add your own MCP servers without code changes:

```yaml
# ~/.config/harness-mcp/catalog/my-servers.yaml
servers:
  - id: my-custom-server
    name: My Custom MCP Server
    description: Does something useful
    type: local
    command:
      - npx
      - -y
      - my-mcp-server
    env_vars:
      - name: API_KEY
        description: Your API key
        required: true
    tags:
      - custom
```

Or project-level: `.harness-mcp/catalog/*.yaml`

## OpenCode Plugin

Use harness-mcp directly within OpenCode:

```json
{
  "plugin": ["@harness-mcp/opencode-plugin"]
}
```

Then ask OpenCode to `use harness_mcp_list` or `use harness_mcp_add to add github`.

## Built-in Catalog

| Server | Type | Category |
|--------|------|----------|
| GitHub | local | git, code-review |
| Filesystem | local | files, system |
| Playwright | local | browser, testing |
| Brave Search | local | search, web |
| Memory | local | knowledge, persistence |
| Sequential Thinking | local | reasoning |
| Fetch | local | web, http |
| Context7 | remote | docs, libraries |
| Sentry | remote | monitoring, errors |
| Grep (Vercel) | remote | code-search |
| Serena | local | code-analysis |
| PostgreSQL | local | database |
| Slack | local | communication |
| Linear | local | project-management |
| Docker | local | containers |
| Puppeteer | local | browser, automation |
| GitLab | local | git, ci-cd |
| Notion | local | docs, knowledge |
| SerpAPI | local | search, web |
