@igor-olikh/openspec-mcp-server 1.0.2 → 1.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.
- package/README.md +26 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
[](https://www.npmjs.com/package/@igor-olikh/openspec-mcp-server)
|
|
4
4
|
[](https://www.npmjs.com/package/@igor-olikh/openspec-mcp-server)
|
|
5
5
|
|
|
6
|
-
Welcome! This is a simple bridge (plugin) that connects **[OpenSpec](https://github.com/Fission-AI/OpenSpec)** to your favorite AI coding assistant (like **
|
|
6
|
+
Welcome! This is a simple bridge (plugin) that connects **[OpenSpec](https://github.com/Fission-AI/OpenSpec)** to your favorite AI coding assistant (like **IBM Bob**, **Codex**, or **Claude Desktop**).
|
|
7
7
|
|
|
8
8
|
## What is this and why do I need it?
|
|
9
9
|
When you want your AI to build a new feature, you usually just type it into the chat. But as projects grow, the AI can forget things, get confused, or write messy code.
|
|
@@ -18,7 +18,29 @@ However, your AI doesn't automatically know how to use OpenSpec. **That is what
|
|
|
18
18
|
|
|
19
19
|
To use this, you need to tell your AI assistant where this server is located. The setup simply depends on which AI assistant you use.
|
|
20
20
|
|
|
21
|
-
### Option 1: Connecting to
|
|
21
|
+
### Option 1: Connecting to IBM Bob (Recommended)
|
|
22
|
+
|
|
23
|
+
If you are using [IBM Bob](https://bob.ibm.com/):
|
|
24
|
+
1. In the IBM Bob IDE, click the **three dots** next to the gear icon in the upper right corner of the chat window and select **MCP servers**.
|
|
25
|
+
2. Click **Open** next to "Global MCPs" to edit your settings file (usually saved at `~/.bob/settings/mcp_settings.json`).
|
|
26
|
+
3. Add the `openspec` server to the `mcpServers` object:
|
|
27
|
+
|
|
28
|
+
```json
|
|
29
|
+
{
|
|
30
|
+
"mcpServers": {
|
|
31
|
+
"openspec": {
|
|
32
|
+
"command": "npx",
|
|
33
|
+
"args": [
|
|
34
|
+
"-y",
|
|
35
|
+
"@igor-olikh/openspec-mcp-server"
|
|
36
|
+
]
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
4. Save the file and restart IBM Bob!
|
|
42
|
+
|
|
43
|
+
### Option 2: Connecting to Codex
|
|
22
44
|
|
|
23
45
|
Codex has a built-in user interface to easily add these plugins.
|
|
24
46
|
You can add it quickly by running this terminal command:
|
|
@@ -38,7 +60,7 @@ codex mcp add openspec-server npx -y @igor-olikh/openspec-mcp-server
|
|
|
38
60
|
6. **Working directory**: Leave this blank! (This allows Codex to dynamically use OpenSpec inside whichever project you currently have open).
|
|
39
61
|
7. Save it!
|
|
40
62
|
|
|
41
|
-
### Option
|
|
63
|
+
### Option 3: Connecting to Claude Desktop App
|
|
42
64
|
|
|
43
65
|
If you prefer using the Claude Desktop application:
|
|
44
66
|
1. Open your Claude configuration file (usually located at `~/Library/Application Support/Claude/claude_desktop_config.json` on Mac).
|
|
@@ -66,7 +88,7 @@ If you prefer using the Claude Desktop application:
|
|
|
66
88
|
Once connected, you don't need to do anything technical. You just talk to your AI like normal, but ask it to use OpenSpec!
|
|
67
89
|
|
|
68
90
|
**Example Chat Prompts:**
|
|
69
|
-
* *"Hey
|
|
91
|
+
* *"Hey Bob, I want to add a dark mode feature to this application. Please use OpenSpec to propose and validate it."*
|
|
70
92
|
* *"What is the OpenSpec status of our current project?"*
|
|
71
93
|
* *"List all the OpenSpec changes we are currently working on."*
|
|
72
94
|
|
package/package.json
CHANGED