@cervellaswarm/mcp-server 0.1.0 → 0.1.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 +47 -17
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -7,9 +7,7 @@
|
|
|
7
7
|
### 1. Install
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
|
|
11
|
-
npm install
|
|
12
|
-
npm run build
|
|
10
|
+
npm install -g @cervellaswarm/mcp-server
|
|
13
11
|
```
|
|
14
12
|
|
|
15
13
|
### 2. Configure Claude Code
|
|
@@ -20,8 +18,7 @@ Add to your `~/.claude/settings.json`:
|
|
|
20
18
|
{
|
|
21
19
|
"mcpServers": {
|
|
22
20
|
"cervellaswarm": {
|
|
23
|
-
"command": "
|
|
24
|
-
"args": ["/path/to/CervellaSwarm/packages/mcp-server/dist/index.js"]
|
|
21
|
+
"command": "cervellaswarm-mcp"
|
|
25
22
|
}
|
|
26
23
|
}
|
|
27
24
|
}
|
|
@@ -33,8 +30,7 @@ Or add to your project's `.mcp.json`:
|
|
|
33
30
|
{
|
|
34
31
|
"mcpServers": {
|
|
35
32
|
"cervellaswarm": {
|
|
36
|
-
"command": "
|
|
37
|
-
"args": ["./packages/mcp-server/dist/index.js"]
|
|
33
|
+
"command": "cervellaswarm-mcp"
|
|
38
34
|
}
|
|
39
35
|
}
|
|
40
36
|
}
|
|
@@ -42,19 +38,27 @@ Or add to your project's `.mcp.json`:
|
|
|
42
38
|
|
|
43
39
|
### 3. Set API Key
|
|
44
40
|
|
|
45
|
-
|
|
41
|
+
Install the CLI and run init:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
npm install -g cervellaswarm
|
|
45
|
+
cervellaswarm init
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Or set environment variable directly:
|
|
46
49
|
|
|
47
50
|
```bash
|
|
48
51
|
export ANTHROPIC_API_KEY=sk-ant-...
|
|
49
52
|
```
|
|
50
53
|
|
|
51
|
-
### 4.
|
|
54
|
+
### 4. Restart Claude Code
|
|
52
55
|
|
|
53
|
-
|
|
56
|
+
Restart Claude Code to load the MCP server. You'll have access to these tools:
|
|
54
57
|
|
|
55
58
|
- **spawn_worker**: Execute tasks with specialized AI workers
|
|
56
|
-
- **list_workers**: See available workers
|
|
57
|
-
- **check_status**: Verify configuration
|
|
59
|
+
- **list_workers**: See available workers and their specialties
|
|
60
|
+
- **check_status**: Verify configuration and API key
|
|
61
|
+
- **check_usage**: Check your usage quota
|
|
58
62
|
|
|
59
63
|
## Available Workers
|
|
60
64
|
|
|
@@ -77,9 +81,14 @@ Use spawn_worker to create a REST API endpoint for user authentication
|
|
|
77
81
|
|
|
78
82
|
Claude Code will call the `spawn_worker` tool with `worker: "backend"` automatically.
|
|
79
83
|
|
|
80
|
-
## Development
|
|
84
|
+
## Development (for contributors)
|
|
81
85
|
|
|
82
86
|
```bash
|
|
87
|
+
# Clone and install
|
|
88
|
+
git clone https://github.com/rafapra/cervellaswarm
|
|
89
|
+
cd cervellaswarm/packages/mcp-server
|
|
90
|
+
npm install
|
|
91
|
+
|
|
83
92
|
# Watch mode
|
|
84
93
|
npm run dev
|
|
85
94
|
|
|
@@ -90,20 +99,41 @@ npm run inspect
|
|
|
90
99
|
npm run build
|
|
91
100
|
```
|
|
92
101
|
|
|
102
|
+
### Local Development Config
|
|
103
|
+
|
|
104
|
+
For local development, use path-based config in `~/.claude/settings.json`:
|
|
105
|
+
|
|
106
|
+
```json
|
|
107
|
+
{
|
|
108
|
+
"mcpServers": {
|
|
109
|
+
"cervellaswarm": {
|
|
110
|
+
"command": "node",
|
|
111
|
+
"args": ["/path/to/CervellaSwarm/packages/mcp-server/dist/index.js"]
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
93
117
|
## Architecture
|
|
94
118
|
|
|
95
119
|
```
|
|
96
|
-
MCP Server
|
|
120
|
+
MCP Server
|
|
97
121
|
│
|
|
98
122
|
├── Tools
|
|
99
|
-
│ ├── spawn_worker → Anthropic API
|
|
123
|
+
│ ├── spawn_worker → Anthropic API (your key)
|
|
100
124
|
│ ├── list_workers → Static list
|
|
101
|
-
│
|
|
125
|
+
│ ├── check_status → Config check
|
|
126
|
+
│ └── check_usage → Quota info
|
|
102
127
|
│
|
|
103
128
|
└── Shares config with CLI
|
|
104
|
-
└──
|
|
129
|
+
└── Uses same API key from cervellaswarm init
|
|
105
130
|
```
|
|
106
131
|
|
|
132
|
+
## Links
|
|
133
|
+
|
|
134
|
+
- CLI: [cervellaswarm on npm](https://www.npmjs.com/package/cervellaswarm)
|
|
135
|
+
- GitHub: [rafapra/cervellaswarm](https://github.com/rafapra/cervellaswarm)
|
|
136
|
+
|
|
107
137
|
---
|
|
108
138
|
|
|
109
139
|
*"16 agents. MCP integration. Your AI team in Claude Code."*
|