sdd-mcp-server 1.1.9 → 1.1.11
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 +36 -21
- package/dist/index.js +9 -3
- package/dist/index.js.map +1 -1
- package/mcp-server.js +8 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@ A Model Context Protocol (MCP) server implementing Spec-Driven Development (SDD)
|
|
|
7
7
|
### Option 1: Install with npx (Recommended)
|
|
8
8
|
```bash
|
|
9
9
|
# Run directly without installation
|
|
10
|
-
npx sdd-mcp-server
|
|
10
|
+
npx sdd-mcp-server@latest
|
|
11
11
|
|
|
12
12
|
# Or install globally
|
|
13
13
|
npm install -g sdd-mcp-server
|
|
@@ -50,16 +50,18 @@ docker-compose up -d
|
|
|
50
50
|
## 🔧 Configuration for AI Clients
|
|
51
51
|
|
|
52
52
|
### Claude Code
|
|
53
|
-
Add to your MCP settings:
|
|
54
|
-
```
|
|
53
|
+
Add to your MCP settings using the command line:
|
|
54
|
+
```bash
|
|
55
|
+
# Add to global MCP configuration
|
|
56
|
+
claude mcp add sdd "npx -y sdd-mcp-server@latest"
|
|
57
|
+
|
|
58
|
+
# Or manually edit ~/.mcp.json:
|
|
55
59
|
{
|
|
56
|
-
"
|
|
60
|
+
"servers": {
|
|
57
61
|
"sdd": {
|
|
62
|
+
"type": "stdio",
|
|
58
63
|
"command": "npx",
|
|
59
|
-
"args": ["sdd-mcp-server"]
|
|
60
|
-
"env": {
|
|
61
|
-
"LOG_LEVEL": "info"
|
|
62
|
-
}
|
|
64
|
+
"args": ["-y", "sdd-mcp-server@latest"]
|
|
63
65
|
}
|
|
64
66
|
}
|
|
65
67
|
}
|
|
@@ -148,12 +150,17 @@ export HOOK_TIMEOUT=10000
|
|
|
148
150
|
```
|
|
149
151
|
|
|
150
152
|
### Claude Code Integration Example
|
|
151
|
-
```
|
|
153
|
+
```bash
|
|
154
|
+
# Add to Claude Code with environment variables
|
|
155
|
+
claude mcp add sdd "npx -y sdd-mcp-server@latest"
|
|
156
|
+
|
|
157
|
+
# Manual configuration in ~/.mcp.json:
|
|
152
158
|
{
|
|
153
|
-
"
|
|
159
|
+
"servers": {
|
|
154
160
|
"sdd": {
|
|
161
|
+
"type": "stdio",
|
|
155
162
|
"command": "npx",
|
|
156
|
-
"args": ["sdd-mcp-server"],
|
|
163
|
+
"args": ["-y", "sdd-mcp-server@latest"],
|
|
157
164
|
"env": {
|
|
158
165
|
"LOG_LEVEL": "info",
|
|
159
166
|
"DEFAULT_LANG": "en"
|
|
@@ -214,26 +221,30 @@ npm run test:coverage # Run with coverage report
|
|
|
214
221
|
|
|
215
222
|
### Common Issues
|
|
216
223
|
|
|
217
|
-
**Issue: "Cannot find module
|
|
224
|
+
**Issue: "Cannot find module sdd-mcp-server"**
|
|
218
225
|
```bash
|
|
219
226
|
# Clear npm cache and reinstall
|
|
220
227
|
npm cache clean --force
|
|
221
|
-
npm install -g
|
|
228
|
+
npm install -g sdd-mcp-server
|
|
222
229
|
```
|
|
223
230
|
|
|
224
|
-
**Issue: "MCP server not responding"**
|
|
231
|
+
**Issue: "MCP server not responding or Failed to connect"**
|
|
225
232
|
```bash
|
|
226
|
-
#
|
|
227
|
-
|
|
233
|
+
# Test server directly
|
|
234
|
+
echo '{"jsonrpc": "2.0", "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}, "id": 1}' | npx -y sdd-mcp-server@latest
|
|
228
235
|
|
|
229
|
-
# Check
|
|
230
|
-
|
|
236
|
+
# Check Claude MCP status
|
|
237
|
+
claude mcp list
|
|
238
|
+
|
|
239
|
+
# Re-add server to Claude MCP
|
|
240
|
+
claude mcp remove sdd
|
|
241
|
+
claude mcp add sdd "npx -y sdd-mcp-server@latest"
|
|
231
242
|
```
|
|
232
243
|
|
|
233
244
|
**Issue: "Permission denied"**
|
|
234
245
|
```bash
|
|
235
246
|
# Fix permissions for global install
|
|
236
|
-
sudo npm install -g
|
|
247
|
+
sudo npm install -g sdd-mcp-server
|
|
237
248
|
```
|
|
238
249
|
|
|
239
250
|
## 📖 Advanced Documentation
|
|
@@ -252,7 +263,7 @@ For detailed documentation on:
|
|
|
252
263
|
|
|
253
264
|
## 🚀 Quick Links
|
|
254
265
|
|
|
255
|
-
- [npm package](https://www.npmjs.com/package
|
|
266
|
+
- [npm package](https://www.npmjs.com/package/sdd-mcp-server)
|
|
256
267
|
- [Docker image](https://ghcr.io/yi-john-huang/sdd-mcp)
|
|
257
268
|
- [Source code](https://github.com/yi-john-huang/sdd-mcp)
|
|
258
269
|
- [Issues](https://github.com/yi-john-huang/sdd-mcp/issues)
|
|
@@ -261,7 +272,11 @@ For detailed documentation on:
|
|
|
261
272
|
|
|
262
273
|
**Ready to get started?**
|
|
263
274
|
```bash
|
|
264
|
-
|
|
275
|
+
# For Claude Code users:
|
|
276
|
+
claude mcp add sdd "npx -y sdd-mcp-server@latest"
|
|
277
|
+
|
|
278
|
+
# For direct usage:
|
|
279
|
+
npx sdd-mcp-server@latest
|
|
265
280
|
```
|
|
266
281
|
|
|
267
282
|
Built for the AI development community 🤖✨
|
package/dist/index.js
CHANGED
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
// MCP SDD Server entry point
|
|
3
3
|
// IMPORTANT: Detect MCP mode and silence console output BEFORE any imports
|
|
4
|
+
// Check multiple indicators for MCP mode
|
|
4
5
|
const isMCPMode = process.argv[1]?.includes('sdd-mcp-server') ||
|
|
5
6
|
process.argv[0]?.includes('sdd-mcp-server') ||
|
|
6
|
-
|
|
7
|
+
process.env.npm_execpath?.includes('npx') || // Executed via npx
|
|
8
|
+
(process.stdin.isTTY === false); // MCP servers communicate via stdio pipes
|
|
7
9
|
if (isMCPMode) {
|
|
8
10
|
// Completely silence all console output for MCP mode
|
|
9
11
|
console.log = () => { };
|
|
@@ -46,10 +48,10 @@ export async function createMCPServer() {
|
|
|
46
48
|
async function createSimpleMCPServer() {
|
|
47
49
|
const { Server } = await import('@modelcontextprotocol/sdk/server/index.js');
|
|
48
50
|
const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
|
|
49
|
-
const { ListToolsRequestSchema, CallToolRequestSchema } = await import('@modelcontextprotocol/sdk/types.js');
|
|
51
|
+
const { ListToolsRequestSchema, CallToolRequestSchema, InitializedNotificationSchema } = await import('@modelcontextprotocol/sdk/types.js');
|
|
50
52
|
const server = new Server({
|
|
51
53
|
name: 'sdd-mcp-server',
|
|
52
|
-
version: '1.1.
|
|
54
|
+
version: '1.1.10'
|
|
53
55
|
}, {
|
|
54
56
|
capabilities: {
|
|
55
57
|
tools: {}
|
|
@@ -103,6 +105,10 @@ async function createSimpleMCPServer() {
|
|
|
103
105
|
throw new Error(`Unknown tool: ${name}`);
|
|
104
106
|
}
|
|
105
107
|
});
|
|
108
|
+
// Handle initialized notification
|
|
109
|
+
server.setNotificationHandler(InitializedNotificationSchema, async () => {
|
|
110
|
+
// Client has completed initialization - server is ready
|
|
111
|
+
});
|
|
106
112
|
const transport = new StdioServerTransport();
|
|
107
113
|
await server.connect(transport);
|
|
108
114
|
}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,6BAA6B;AAE7B,2EAA2E;AAC3E,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC;IAC3C,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,0CAA0C;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/mcp-server.js
CHANGED
|
@@ -11,12 +11,13 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
|
11
11
|
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
12
12
|
import {
|
|
13
13
|
ListToolsRequestSchema,
|
|
14
|
-
CallToolRequestSchema
|
|
14
|
+
CallToolRequestSchema,
|
|
15
|
+
InitializedNotificationSchema
|
|
15
16
|
} from '@modelcontextprotocol/sdk/types.js';
|
|
16
17
|
|
|
17
18
|
const server = new Server({
|
|
18
19
|
name: 'sdd-mcp-server',
|
|
19
|
-
version: '1.1.
|
|
20
|
+
version: '1.1.10'
|
|
20
21
|
}, {
|
|
21
22
|
capabilities: {
|
|
22
23
|
tools: {}
|
|
@@ -74,5 +75,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
|
74
75
|
}
|
|
75
76
|
});
|
|
76
77
|
|
|
78
|
+
// Handle initialized notification
|
|
79
|
+
server.setNotificationHandler(InitializedNotificationSchema, async () => {
|
|
80
|
+
// Client has completed initialization - server is ready
|
|
81
|
+
});
|
|
82
|
+
|
|
77
83
|
const transport = new StdioServerTransport();
|
|
78
84
|
await server.connect(transport);
|