@feedmob/github-issues 0.0.9 → 1.0.0

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 +33 -6
  2. package/package.json +2 -1
package/README.md CHANGED
@@ -35,17 +35,33 @@ npm run build
35
35
 
36
36
  ### Example MCP Client Config (stdio)
37
37
 
38
- Use the built artifact (`dist/index.js`) after `npm run build`:
38
+ **Recommended (avoids completions capability issue):** run from the built artifact when you have the repo. After `npm run build` in `src/github-issues/`:
39
+
40
+ ```json
41
+ {
42
+ "mcpServers": {
43
+ "feedmob-github-issues": {
44
+ "command": "node",
45
+ "args": ["/absolute/path/to/fm-mcp-servers/src/github-issues/dist/index.js"],
46
+ "env": {
47
+ "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx",
48
+ "GITHUB_DEFAULT_OWNER": "feedmob",
49
+ "AI_API_URL": "https://your-feedmob-api.example.com",
50
+ "AI_API_TOKEN": "your-feedmob-api-token"
51
+ }
52
+ }
53
+ }
54
+ }
55
+ ```
56
+
57
+ Alternatively, use `npx` (do **not** use `npm install -g @feedmob/github-issues`; global install ignores the package’s SDK override and can cause the “Server does not support completions” error):
39
58
 
40
59
  ```json
41
60
  {
42
61
  "mcpServers": {
43
62
  "feedmob-github-issues": {
44
63
  "command": "npx",
45
- "args": [
46
- "-y",
47
- "@feedmob/github-issues"
48
- ],
64
+ "args": ["-y", "@feedmob/github-issues"],
49
65
  "env": {
50
66
  "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx",
51
67
  "GITHUB_DEFAULT_OWNER": "feedmob",
@@ -140,7 +156,18 @@ npx tsx index.ts
140
156
 
141
157
  Cursor (and other MCP clients using protocol 2025-11-25) may request the `completion/complete` capability. FastMCP 2.1 uses `@modelcontextprotocol/sdk`; SDK **1.22.0+** requires the server to advertise the completions capability when registering a completion handler, but FastMCP does not set it, so the server crashes on start.
142
158
 
143
- **Fix:** This package pins the SDK to **1.21.2** via `overrides` in `package.json`. After pulling, run `npm install` in `src/github-issues/` so the override is applied. If you use `npx -y @feedmob/github-issues`, reinstall or use the local build: `node /path/to/fm-mcp-servers/src/github-issues/dist/index.js`.
159
+ **Fix:**
160
+
161
+ 1. **Preferred:** Run from the repo so the package’s SDK pin is used. In Cursor MCP config, use the built server instead of `npx` or a global install:
162
+ ```json
163
+ "command": "node",
164
+ "args": ["/absolute/path/to/fm-mcp-servers/src/github-issues/dist/index.js"]
165
+ ```
166
+ Run `npm install` and `npm run build` in `src/github-issues/` first.
167
+
168
+ 2. **If you use npx:** Avoid `npm install -g @feedmob/github-issues`. npm applies `overrides` only from the root project; a global install has no root `package.json`, so the pin is ignored and the crash can occur. Use `npx -y @feedmob/github-issues` (npx uses the package as root so the override applies), or switch to the local path above.
169
+
170
+ 3. **Local dev:** This package pins the SDK to **1.21.2** via `overrides` and a direct dependency. After pulling, run `npm install` in `src/github-issues/` so the pin is applied.
144
171
 
145
172
  ### `SyntaxError: Unexpected token ':'` with JSON on stdin
146
173
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@feedmob/github-issues",
3
- "version": "0.0.9",
3
+ "version": "1.0.0",
4
4
  "description": "MCP server for using the GitHub API",
5
5
  "license": "MIT",
6
6
  "author": "FeedMob",
@@ -19,6 +19,7 @@
19
19
  "watch": "tsc --watch"
20
20
  },
21
21
  "dependencies": {
22
+ "@modelcontextprotocol/sdk": "1.21.2",
22
23
  "@types/node": "^22",
23
24
  "@types/node-fetch": "^2.6.12",
24
25
  "date-fns": "^4.1.0",