@caffeineai/mcp 0.1.0-dev.4 → 0.1.0-dev.41
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 +70 -111
- package/package.json +16 -13
package/README.md
CHANGED
|
@@ -1,65 +1,44 @@
|
|
|
1
1
|
# @caffeineai/mcp
|
|
2
2
|
|
|
3
|
-
MCP server that
|
|
3
|
+
An MCP server that exposes Caffeine auth, project, build, config, and chat
|
|
4
|
+
operations to AI coding hosts.
|
|
4
5
|
|
|
5
6
|
## Development Release
|
|
6
7
|
|
|
7
|
-
This is a DEV release. It is published under the npm `dev` dist-tag and is
|
|
8
|
+
This is a DEV release. It is published under the npm `dev` dist-tag and is
|
|
9
|
+
subject to a rapid release cadence. Expect frequent updates while the MCP
|
|
10
|
+
package settles.
|
|
8
11
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
## Prerequisites
|
|
12
|
-
|
|
13
|
-
Node.js 20 or later.
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
node --version
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
The MCP server includes its own auth tools. You do not need to install or log in with the CLI first.
|
|
20
|
-
|
|
21
|
-
## Pre-Warm The Package Cache
|
|
22
|
-
|
|
23
|
-
The published package contains a native binary. `npx -y` caches it after the first download, but the first invocation often happens inside an MCP host process with a startup timeout. On a slow connection the host can mark the server as offline before the download finishes.
|
|
24
|
-
|
|
25
|
-
Run this once in a terminal before relying on the server from any host:
|
|
12
|
+
## Quick Start
|
|
26
13
|
|
|
27
14
|
```bash
|
|
28
15
|
npx -y @caffeineai/mcp@dev --version
|
|
29
16
|
```
|
|
30
17
|
|
|
31
|
-
|
|
18
|
+
The first run pre-warms the package cache. That matters because MCP hosts often
|
|
19
|
+
apply startup timeouts, and a cold binary download can make the server look
|
|
20
|
+
offline even though the install is still in progress.
|
|
32
21
|
|
|
33
|
-
|
|
22
|
+
The server includes its own auth tools. You do not need to install the CLI
|
|
23
|
+
first.
|
|
34
24
|
|
|
35
|
-
|
|
25
|
+
## Install Into Your Host
|
|
36
26
|
|
|
37
27
|
### Claude Code
|
|
38
28
|
|
|
39
|
-
User-wide:
|
|
40
|
-
|
|
41
29
|
```bash
|
|
42
30
|
claude mcp add --transport stdio --scope user caffeine -- npx -y @caffeineai/mcp@dev
|
|
43
31
|
```
|
|
44
32
|
|
|
45
|
-
|
|
33
|
+
### OpenAI Codex
|
|
46
34
|
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
"mcpServers": {
|
|
50
|
-
"caffeine": {
|
|
51
|
-
"command": "npx",
|
|
52
|
-
"args": ["-y", "@caffeineai/mcp@dev"]
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
}
|
|
35
|
+
```bash
|
|
36
|
+
codex mcp add caffeine -- npx -y @caffeineai/mcp@dev
|
|
56
37
|
```
|
|
57
38
|
|
|
58
|
-
Inside Claude Code, type `/mcp` to see server status.
|
|
59
|
-
|
|
60
39
|
### Cursor
|
|
61
40
|
|
|
62
|
-
`.cursor/mcp.json`
|
|
41
|
+
Add this to `.cursor/mcp.json` or `~/.cursor/mcp.json`:
|
|
63
42
|
|
|
64
43
|
```json
|
|
65
44
|
{
|
|
@@ -73,49 +52,15 @@ Inside Claude Code, type `/mcp` to see server status.
|
|
|
73
52
|
}
|
|
74
53
|
```
|
|
75
54
|
|
|
76
|
-
Restart Cursor after adding the config.
|
|
77
|
-
|
|
78
55
|
### VS Code With GitHub Copilot
|
|
79
56
|
|
|
80
57
|
```bash
|
|
81
58
|
code --add-mcp '{"name":"caffeine","command":"npx","args":["-y","@caffeineai/mcp@dev"]}'
|
|
82
59
|
```
|
|
83
60
|
|
|
84
|
-
Or `.vscode/mcp.json`:
|
|
85
|
-
|
|
86
|
-
```json
|
|
87
|
-
{
|
|
88
|
-
"servers": {
|
|
89
|
-
"caffeine": {
|
|
90
|
-
"type": "stdio",
|
|
91
|
-
"command": "npx",
|
|
92
|
-
"args": ["-y", "@caffeineai/mcp@dev"]
|
|
93
|
-
}
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
Verify via the command palette: `MCP: List Servers`.
|
|
99
|
-
|
|
100
|
-
### OpenAI Codex
|
|
101
|
-
|
|
102
|
-
```bash
|
|
103
|
-
codex mcp add caffeine -- npx -y @caffeineai/mcp@dev
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
Or `~/.codex/config.toml`:
|
|
107
|
-
|
|
108
|
-
```toml
|
|
109
|
-
[mcp_servers.caffeine]
|
|
110
|
-
command = "npx"
|
|
111
|
-
args = ["-y", "@caffeineai/mcp@dev"]
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
Verify with `codex mcp list`.
|
|
115
|
-
|
|
116
61
|
### Windsurf
|
|
117
62
|
|
|
118
|
-
`~/.codeium/windsurf/mcp_config.json`:
|
|
63
|
+
Add this to `~/.codeium/windsurf/mcp_config.json`:
|
|
119
64
|
|
|
120
65
|
```json
|
|
121
66
|
{
|
|
@@ -128,29 +73,55 @@ Verify with `codex mcp list`.
|
|
|
128
73
|
}
|
|
129
74
|
```
|
|
130
75
|
|
|
131
|
-
Quit and reopen Windsurf after adding the config.
|
|
132
|
-
|
|
133
76
|
## Available Tools
|
|
134
77
|
|
|
135
|
-
| Tool | Description |
|
|
136
|
-
| --- | --- |
|
|
137
|
-
| `caffeine_auth_login` | Start a
|
|
138
|
-
| `caffeine_auth_logout` | Log out and clear local credentials |
|
|
139
|
-
| `caffeine_auth_status` | Check authentication status |
|
|
140
|
-
| `caffeine_list_projects` | List
|
|
141
|
-
| `caffeine_show_project` | Get project details |
|
|
142
|
-
| `caffeine_create_project` | Create a project |
|
|
143
|
-
| `caffeine_delete_project` | Delete a project |
|
|
144
|
-
| `caffeine_clone_project` | Clone a project locally |
|
|
145
|
-
| `caffeine_import_project` | Import a project from a
|
|
146
|
-
| `caffeine_export_project` | Export the current project to a
|
|
147
|
-
| `caffeine_build` | Build the project |
|
|
148
|
-
| `caffeine_check` | Validate code and configuration |
|
|
149
|
-
| `caffeine_preview` | Upload a built project as a draft |
|
|
150
|
-
| `
|
|
151
|
-
|
|
|
152
|
-
|
|
153
|
-
|
|
78
|
+
| Group | Tool | Description |
|
|
79
|
+
| --- | --- | --- |
|
|
80
|
+
| Auth | `caffeine_auth_login` | Start a browser or device login flow |
|
|
81
|
+
| Auth | `caffeine_auth_logout` | Log out and clear local credentials |
|
|
82
|
+
| Auth | `caffeine_auth_status` | Check authentication status |
|
|
83
|
+
| Projects | `caffeine_list_projects` | List projects |
|
|
84
|
+
| Projects | `caffeine_show_project` | Get project details |
|
|
85
|
+
| Projects | `caffeine_create_project` | Create a project |
|
|
86
|
+
| Projects | `caffeine_delete_project` | Delete a project |
|
|
87
|
+
| Projects | `caffeine_clone_project` | Clone a project locally |
|
|
88
|
+
| Local | `caffeine_import_project` | Import a project from a `.zip` |
|
|
89
|
+
| Local | `caffeine_export_project` | Export the current project to a `.zip` |
|
|
90
|
+
| Build | `caffeine_build` | Build the project |
|
|
91
|
+
| Build | `caffeine_check` | Validate code and configuration |
|
|
92
|
+
| Build | `caffeine_preview` | Upload a built project as a draft |
|
|
93
|
+
| Config | `caffeine_config_list` / `caffeine_config_get` / `caffeine_config_set` | Manage CLI config |
|
|
94
|
+
| Env | `caffeine_doctor` | Diagnose local toolchain health |
|
|
95
|
+
| Chat | `caffeine_chat_start_session` | Start a chat session |
|
|
96
|
+
| Chat | `caffeine_chat_active_sessions` | Discover likely active chat sessions |
|
|
97
|
+
| Chat | `caffeine_chat_resume_session` | Reattach and wait for the next stable state |
|
|
98
|
+
| Chat | `caffeine_chat_watch_session` | Stream live session updates |
|
|
99
|
+
| Chat | `caffeine_chat_session_status` | Summarize an active session |
|
|
100
|
+
| Chat | `caffeine_chat_session_transcript` | Show the current transcript |
|
|
101
|
+
| Chat | `caffeine_chat_session_feed` | Collect raw feed events |
|
|
102
|
+
| Chat | `caffeine_chat_detach_session` | Mark a client-side session as detached |
|
|
103
|
+
| Chat | `caffeine_chat_send` | Send a prompt |
|
|
104
|
+
| Chat | `caffeine_chat_reply` | Send a freeform clarification reply |
|
|
105
|
+
| Chat | `caffeine_chat_list` | List chat messages |
|
|
106
|
+
| Chat | `caffeine_chat_tail` | Poll messages until the AI reaches a stable state |
|
|
107
|
+
| Chat | `caffeine_chat_submit_form` | Submit a structured clarification form reply |
|
|
108
|
+
| Chat | `caffeine_chat_url` | Return the browser chat URL |
|
|
109
|
+
|
|
110
|
+
These tools sit on top of `@caffeine/sdk`, so they use the same underlying
|
|
111
|
+
chat contract as the CLI.
|
|
112
|
+
|
|
113
|
+
## Example Operations
|
|
114
|
+
|
|
115
|
+
- Log in from your MCP host, then inspect or clone projects
|
|
116
|
+
- Build, check, preview, import, export, or diagnose a local project from the same host
|
|
117
|
+
- Start an interactive chat session and watch it live
|
|
118
|
+
- Detach and later resume or inspect likely active sessions
|
|
119
|
+
- Read the high-level session status, transcript, or raw feed events
|
|
120
|
+
- Submit a structured clarification form from a `system_dialog` message
|
|
121
|
+
- Hand off to the browser chat when needed
|
|
122
|
+
|
|
123
|
+
All tools return the same stable `{ ok, data }` / `{ ok, error }` envelope
|
|
124
|
+
used by the CLI's `--json` mode.
|
|
154
125
|
|
|
155
126
|
## Supported Platforms
|
|
156
127
|
|
|
@@ -162,23 +133,11 @@ Native binaries ship for:
|
|
|
162
133
|
|
|
163
134
|
## Troubleshooting
|
|
164
135
|
|
|
165
|
-
-
|
|
166
|
-
-
|
|
167
|
-
-
|
|
168
|
-
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
With no host running, you can pipe a JSON-RPC request directly:
|
|
173
|
-
|
|
174
|
-
```bash
|
|
175
|
-
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx -y @caffeineai/mcp@dev
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
## Links
|
|
179
|
-
|
|
180
|
-
- Source, issues, and release notes: https://github.com/caffeinelabs/caffeine-cli
|
|
181
|
-
- Caffeine platform: https://caffeine.ai
|
|
182
|
-
- Model Context Protocol: https://modelcontextprotocol.io
|
|
136
|
+
- If the server appears offline on first use, run `npx -y @caffeineai/mcp@dev --version` in a terminal, then restart the host.
|
|
137
|
+
- If you see auth errors, call `caffeine_auth_login`, complete the flow, then call `caffeine_auth_status`.
|
|
138
|
+
- `caffeine_chat_watch_session` and `caffeine_chat_resume_session` are the
|
|
139
|
+
main live-session tools for interactive hosts.
|
|
140
|
+
- `caffeine_chat_feed` exposes raw project feed events when a host wants lower
|
|
141
|
+
level progress data.
|
|
183
142
|
|
|
184
143
|
This package installs the matching platform binary through npm optional dependencies. Install the main package rather than a platform package directly.
|
package/package.json
CHANGED
|
@@ -1,11 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@caffeineai/mcp",
|
|
3
|
-
"version": "0.1.0-dev.
|
|
3
|
+
"version": "0.1.0-dev.41",
|
|
4
4
|
"description": "Caffeine MCP server",
|
|
5
|
-
"
|
|
6
|
-
"type": "git",
|
|
7
|
-
"url": "git+https://github.com/caffeinelabs/caffeine-cli.git"
|
|
8
|
-
},
|
|
5
|
+
"homepage": "https://caffeine.ai",
|
|
9
6
|
"license": "SEE LICENSE IN LICENSE",
|
|
10
7
|
"bin": {
|
|
11
8
|
"caffeine-mcp": "bin/caffeine-mcp.js"
|
|
@@ -16,16 +13,22 @@
|
|
|
16
13
|
"LICENSE"
|
|
17
14
|
],
|
|
18
15
|
"optionalDependencies": {
|
|
19
|
-
"@caffeineai/mcp-darwin-arm64": "0.1.0-dev.
|
|
20
|
-
"@caffeineai/mcp-darwin-x64": "0.1.0-dev.
|
|
21
|
-
"@caffeineai/mcp-linux-arm64-glibc": "0.1.0-dev.
|
|
22
|
-
"@caffeineai/mcp-linux-x64-glibc": "0.1.0-dev.
|
|
23
|
-
"@caffeineai/mcp-linux-arm64-musl": "0.1.0-dev.
|
|
24
|
-
"@caffeineai/mcp-linux-x64-musl": "0.1.0-dev.
|
|
25
|
-
"@caffeineai/mcp-win32-arm64": "0.1.0-dev.
|
|
26
|
-
"@caffeineai/mcp-win32-x64": "0.1.0-dev.
|
|
16
|
+
"@caffeineai/mcp-darwin-arm64": "0.1.0-dev.41",
|
|
17
|
+
"@caffeineai/mcp-darwin-x64": "0.1.0-dev.41",
|
|
18
|
+
"@caffeineai/mcp-linux-arm64-glibc": "0.1.0-dev.41",
|
|
19
|
+
"@caffeineai/mcp-linux-x64-glibc": "0.1.0-dev.41",
|
|
20
|
+
"@caffeineai/mcp-linux-arm64-musl": "0.1.0-dev.41",
|
|
21
|
+
"@caffeineai/mcp-linux-x64-musl": "0.1.0-dev.41",
|
|
22
|
+
"@caffeineai/mcp-win32-arm64": "0.1.0-dev.41",
|
|
23
|
+
"@caffeineai/mcp-win32-x64": "0.1.0-dev.41"
|
|
27
24
|
},
|
|
25
|
+
"preferGlobal": true,
|
|
28
26
|
"publishConfig": {
|
|
29
27
|
"access": "public"
|
|
28
|
+
},
|
|
29
|
+
"caffeine": {
|
|
30
|
+
"distribution": "npmjs",
|
|
31
|
+
"packageName": "@caffeineai/mcp",
|
|
32
|
+
"publishedAt": "2026-06-17T17:02:43.248Z"
|
|
30
33
|
}
|
|
31
34
|
}
|