captain-tool 0.0.1 → 0.0.3

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.
Files changed (2) hide show
  1. package/README.md +166 -0
  2. package/package.json +5 -5
package/README.md ADDED
@@ -0,0 +1,166 @@
1
+ # captain-tool
2
+
3
+ An MCP server that connects your AI coding agent to [Captain](https://app.getcaptain.dev) — a release train management and SDLC orchestration platform.
4
+
5
+ Once installed, your AI agent can interact with your Captain workspace directly in conversation: checking pipeline status, reviewing deployments, managing artifacts, and more.
6
+
7
+ ---
8
+
9
+ ## Supported clients
10
+
11
+ - Claude Desktop
12
+ - Claude Code (CLI)
13
+ - VS Code + Copilot
14
+ - Cursor
15
+ - Windsurf
16
+
17
+ ---
18
+
19
+ ## Requirements
20
+
21
+ - Node.js 16+
22
+ - A [Captain](https://app.getcaptain.dev) account
23
+ - One of the supported AI clients above
24
+
25
+ ---
26
+
27
+ ## Installation
28
+
29
+ ```bash
30
+ npm install -g captain-tool
31
+ ```
32
+
33
+ ---
34
+
35
+ ## Setup (recommended)
36
+
37
+ Run the interactive setup wizard to automatically configure your AI client(s):
38
+
39
+ ```bash
40
+ captain-tool setup
41
+ ```
42
+
43
+ The wizard will detect your platform, find the binary, and write the correct MCP config for whichever client(s) you select. Supports all 5 clients above in one step.
44
+
45
+ ---
46
+
47
+ ## Manual setup
48
+
49
+ ### Claude Desktop
50
+
51
+ Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
52
+
53
+ ```json
54
+ {
55
+ "mcpServers": {
56
+ "captain-tool": {
57
+ "command": "captain-tool",
58
+ "env": {
59
+ "CAPTAIN_API_URL": "https://app.getcaptain.dev/"
60
+ }
61
+ }
62
+ }
63
+ }
64
+ ```
65
+
66
+ Restart Claude Desktop to activate.
67
+
68
+ ### Claude Code (CLI)
69
+
70
+ ```bash
71
+ claude mcp add captain-tool -- cmd /c captain-tool
72
+ ```
73
+
74
+ ### VS Code + Copilot
75
+
76
+ [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-0098FF?logo=visualstudiocode)](vscode:mcp/install?%7B%22name%22%3A%22captain-tool%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22captain-tool%22%5D%2C%22env%22%3A%7B%22CAPTAIN_API_URL%22%3A%22https%3A%2F%2Fapp.getcaptain.dev%2F%22%7D%7D)
77
+
78
+ Or edit `%APPDATA%\Code\User\mcp.json` (Windows) / `~/.config/Code/User/mcp.json` (Linux) / `~/Library/Application Support/Code/User/mcp.json` (macOS):
79
+
80
+ ```json
81
+ {
82
+ "servers": {
83
+ "captain-tool": {
84
+ "type": "stdio",
85
+ "command": "captain-tool",
86
+ "env": {
87
+ "CAPTAIN_API_URL": "https://app.getcaptain.dev/"
88
+ }
89
+ }
90
+ }
91
+ }
92
+ ```
93
+
94
+ Reload VS Code (`Ctrl+Shift+P` → "Developer: Reload Window") to activate.
95
+
96
+ ### Cursor
97
+
98
+ Edit `~/.cursor/mcp.json`:
99
+
100
+ ```json
101
+ {
102
+ "mcpServers": {
103
+ "captain-tool": {
104
+ "command": "captain-tool",
105
+ "env": {
106
+ "CAPTAIN_API_URL": "https://app.getcaptain.dev/"
107
+ }
108
+ }
109
+ }
110
+ }
111
+ ```
112
+
113
+ Restart Cursor to activate.
114
+
115
+ ### Windsurf
116
+
117
+ Edit `~/.codeium/windsurf/mcp_config.json` (macOS/Linux) or `%USERPROFILE%\.codeium\windsurf\mcp_config.json` (Windows):
118
+
119
+ ```json
120
+ {
121
+ "mcpServers": {
122
+ "captain-tool": {
123
+ "command": "captain-tool",
124
+ "env": {
125
+ "CAPTAIN_API_URL": "https://app.getcaptain.dev/"
126
+ }
127
+ }
128
+ }
129
+ }
130
+ ```
131
+
132
+ Restart Windsurf to activate.
133
+
134
+ ---
135
+
136
+ ## First use
137
+
138
+ Once connected, ask your AI agent:
139
+
140
+ > "Check captain status and get me set up."
141
+
142
+ It will walk you through logging in and selecting your workspace. After that, you can ask things like:
143
+
144
+ ```
145
+ Show me all my pipelines.
146
+ What's the current state of my active workspace?
147
+ List any unhealthy connectors.
148
+ What components do we have?
149
+ Show me the deployment history for component comp-xyz.
150
+ ```
151
+
152
+ ---
153
+
154
+ ## Configuration
155
+
156
+ | Variable | Default | Description |
157
+ |----------|---------|-------------|
158
+ | `CAPTAIN_API_URL` | `https://app.getcaptain.dev/` | Captain backend URL |
159
+ | `CAPTAIN_DB_PATH` | platform default | Local state and auth token |
160
+ | `CAPTAIN_REQUEST_TIMEOUT_SECONDS` | `30` | HTTP timeout per request |
161
+
162
+ ---
163
+
164
+ ## Learn more
165
+
166
+ Visit [app.getcaptain.dev](https://app.getcaptain.dev) to learn more about Captain.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "captain-tool",
3
- "version": "0.0.1",
3
+ "version": "0.0.3",
4
4
  "description": "MCP server connecting Claude Desktop and VS Code Copilot to Captain Cloud",
5
5
  "bin": {
6
6
  "captain-tool": "bin/captain-tool",
@@ -10,10 +10,10 @@
10
10
  "postinstall": "node scripts/postinstall.js"
11
11
  },
12
12
  "optionalDependencies": {
13
- "@captain-tool/captain-tool-win32-x64": "0.0.1",
14
- "@captain-tool/captain-tool-darwin-x64": "0.0.1",
15
- "@captain-tool/captain-tool-darwin-arm64": "0.0.1",
16
- "@captain-tool/captain-tool-linux-x64": "0.0.1"
13
+ "@captain-tool/captain-tool-win32-x64": "0.0.3",
14
+ "@captain-tool/captain-tool-darwin-x64": "0.0.3",
15
+ "@captain-tool/captain-tool-darwin-arm64": "0.0.3",
16
+ "@captain-tool/captain-tool-linux-x64": "0.0.3"
17
17
  },
18
18
  "files": [
19
19
  "bin/",