harmony-mcp 1.9.7 → 1.10.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +40 -12
- package/dist/cli.js +17236 -17027
- package/dist/index.js +17415 -17206
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -45,7 +45,7 @@ That's it! You're ready to use Harmony with your AI agent.
|
|
|
45
45
|
|
|
46
46
|
## Remote MCP (Hosted)
|
|
47
47
|
|
|
48
|
-
|
|
48
|
+
Connect any MCP-compatible agent to Harmony's hosted endpoint - no local server required.
|
|
49
49
|
|
|
50
50
|
**Endpoint:** `https://mcp.gethmy.com/mcp`
|
|
51
51
|
|
|
@@ -53,20 +53,47 @@ If your AI tool supports remote MCP servers natively (e.g., Claude.ai), you can
|
|
|
53
53
|
|
|
54
54
|
**Authentication:** Bearer token using your `hmy_` API key
|
|
55
55
|
|
|
56
|
+
### Universal Setup with `add-mcp`
|
|
57
|
+
|
|
58
|
+
The fastest way to connect any agent to the remote endpoint. One command configures Claude Code, Cursor, VS Code, Windsurf, Codex, and more:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
npx add-mcp https://mcp.gethmy.com/mcp -- --header "Authorization: Bearer hmy_your_key_here"
|
|
56
62
|
```
|
|
57
|
-
|
|
63
|
+
|
|
64
|
+
**Useful flags:**
|
|
65
|
+
|
|
66
|
+
| Flag | Description |
|
|
67
|
+
| ---- | ----------- |
|
|
68
|
+
| `-g` | Install globally (not scoped to a project) |
|
|
69
|
+
| `-a <agent>` | Target specific agents (e.g., `-a cursor -a claude-code`) |
|
|
70
|
+
| `-y` | Skip interactive prompts |
|
|
71
|
+
|
|
72
|
+
**Examples:**
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# Install for all detected agents
|
|
76
|
+
npx add-mcp https://mcp.gethmy.com/mcp -- --header "Authorization: Bearer hmy_your_key_here"
|
|
77
|
+
|
|
78
|
+
# Install globally for Cursor and Claude Code only
|
|
79
|
+
npx add-mcp https://mcp.gethmy.com/mcp -g -a cursor -a claude-code -- --header "Authorization: Bearer hmy_your_key_here"
|
|
80
|
+
|
|
81
|
+
# Non-interactive (CI-friendly)
|
|
82
|
+
npx add-mcp https://mcp.gethmy.com/mcp -y -- --header "Authorization: Bearer hmy_your_key_here"
|
|
58
83
|
```
|
|
59
84
|
|
|
60
|
-
|
|
85
|
+
### Manual Setup (Claude.ai)
|
|
86
|
+
|
|
87
|
+
If you prefer to configure manually (e.g., in Claude.ai's UI):
|
|
61
88
|
|
|
62
89
|
1. Get an API key from [Harmony](https://gethmy.com/user/keys)
|
|
63
90
|
2. In Claude.ai, add a remote MCP server with URL `https://mcp.gethmy.com/mcp`
|
|
64
91
|
3. Set the Authorization header to `Bearer hmy_your_key_here`
|
|
65
92
|
4. All 43+ Harmony tools become available in your conversation
|
|
66
93
|
|
|
67
|
-
**Session management** is automatic
|
|
94
|
+
**Session management** is automatic - sessions have a 1-hour TTL and are created/renewed transparently.
|
|
68
95
|
|
|
69
|
-
> **When to use remote vs local:**
|
|
96
|
+
> **When to use remote vs local:** The remote endpoint (via `add-mcp` or manual config) works with any MCP-compatible agent and requires no local server. Use the local server (`npx harmony-mcp setup`) when you need skills, local project context, or memory sync to local markdown files.
|
|
70
97
|
|
|
71
98
|
### Adding to a New Project
|
|
72
99
|
|
|
@@ -112,13 +139,14 @@ npx harmony-mcp serve # Start MCP server
|
|
|
112
139
|
|
|
113
140
|
## Supported AI Agents
|
|
114
141
|
|
|
115
|
-
| Agent | Workflow Command | Config Location | Transport
|
|
116
|
-
| ---------------- | ------------------------ | ------------------------------------- |
|
|
117
|
-
| **Claude Code** | `/hmy #42` | `~/.claude/settings.json` | Local (stdio)
|
|
118
|
-
| **OpenAI Codex** | `/prompts:hmy #42` | `~/.codex/config.toml` | Local (stdio)
|
|
119
|
-
| **Cursor** | MCP tools auto-available | `.cursor/mcp.json` | Local (stdio)
|
|
120
|
-
| **Windsurf** | MCP tools auto-available | `~/.codeium/windsurf/mcp_config.json` | Local (stdio)
|
|
121
|
-
| **Claude.ai** | MCP tools auto-available | Remote MCP settings in Claude.ai | Remote (HTTP)
|
|
142
|
+
| Agent | Workflow Command | Config Location | Transport |
|
|
143
|
+
| ---------------- | ------------------------ | ------------------------------------- | --------------------- |
|
|
144
|
+
| **Claude Code** | `/hmy #42` | `~/.claude/settings.json` | Local (stdio) |
|
|
145
|
+
| **OpenAI Codex** | `/prompts:hmy #42` | `~/.codex/config.toml` | Local (stdio) |
|
|
146
|
+
| **Cursor** | MCP tools auto-available | `.cursor/mcp.json` | Local (stdio) |
|
|
147
|
+
| **Windsurf** | MCP tools auto-available | `~/.codeium/windsurf/mcp_config.json` | Local (stdio) |
|
|
148
|
+
| **Claude.ai** | MCP tools auto-available | Remote MCP settings in Claude.ai | Remote (HTTP) |
|
|
149
|
+
| **Any agent** | MCP tools auto-available | Auto-configured via `npx add-mcp` | Remote (HTTP) |
|
|
122
150
|
|
|
123
151
|
## Card Workflow
|
|
124
152
|
|