@rectify-so/mcp 1.0.0 → 1.0.1
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 +71 -86
- package/dist/constants.d.ts.map +1 -1
- package/dist/constants.js +1 -1
- package/dist/constants.js.map +1 -1
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -8,6 +8,70 @@ An MCP (Model Context Protocol) server to access Rectify project resources from
|
|
|
8
8
|
npm i -g @rectify-so/mcp
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
+
## Production Usage
|
|
12
|
+
|
|
13
|
+
### Command Line
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
rectify-mcp --token mcp_xxx:userId
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### IDE Configuration
|
|
20
|
+
|
|
21
|
+
Copy just the top-level `rectify` block (do not wrap in `mcpServers` unless your IDE requires it):
|
|
22
|
+
|
|
23
|
+
```json
|
|
24
|
+
{
|
|
25
|
+
"rectify": {
|
|
26
|
+
"command": "npx",
|
|
27
|
+
"args": ["-y", "@rectify-so/mcp", "--token", "mcp_xxx:userId"]
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
#### Claude Desktop
|
|
33
|
+
|
|
34
|
+
Add to Claude Desktop config:
|
|
35
|
+
|
|
36
|
+
**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`
|
|
37
|
+
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
38
|
+
|
|
39
|
+
```json
|
|
40
|
+
{
|
|
41
|
+
"mcpServers": {
|
|
42
|
+
"rectify": {
|
|
43
|
+
"command": "npx",
|
|
44
|
+
"args": [
|
|
45
|
+
"-y",
|
|
46
|
+
"@rectify-so/mcp",
|
|
47
|
+
"--token",
|
|
48
|
+
"mcp_xxx:userId",
|
|
49
|
+
]
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
#### Cursor
|
|
56
|
+
|
|
57
|
+
Add to Cursor settings:
|
|
58
|
+
|
|
59
|
+
```json
|
|
60
|
+
{
|
|
61
|
+
"mcp.servers": {
|
|
62
|
+
"rectify": {
|
|
63
|
+
"command": "npx",
|
|
64
|
+
"args": [
|
|
65
|
+
"-y",
|
|
66
|
+
"@rectify-so/mcp",
|
|
67
|
+
"--token",
|
|
68
|
+
"mcp_xxx:userId",
|
|
69
|
+
]
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
11
75
|
## Local Development
|
|
12
76
|
|
|
13
77
|
### Prerequisites
|
|
@@ -47,18 +111,12 @@ npx tsx src/cli.ts --token mcp_xxx:userId
|
|
|
47
111
|
|
|
48
112
|
### Testing with MCP Inspector
|
|
49
113
|
|
|
50
|
-
|
|
114
|
+
Run the server inside MCP Inspector:
|
|
51
115
|
|
|
52
|
-
1. **Run with MCP Inspector:**
|
|
53
116
|
```bash
|
|
54
117
|
npx @modelcontextprotocol/inspector node dist/cli.js --token mcp_xxx:userId
|
|
55
118
|
```
|
|
56
119
|
|
|
57
|
-
2. **The inspector will:**
|
|
58
|
-
- Start your MCP server
|
|
59
|
-
- Open a web interface (usually at http://localhost:5173)
|
|
60
|
-
- Allow you to test resources and see responses
|
|
61
|
-
|
|
62
120
|
### Testing in IDE (Local Development)
|
|
63
121
|
|
|
64
122
|
#### Windsurf Local Testing
|
|
@@ -95,7 +153,7 @@ Update Claude config (`%APPDATA%/Claude/claude_desktop_config.json` on Windows o
|
|
|
95
153
|
|
|
96
154
|
Enable verbose logging to see detailed output:
|
|
97
155
|
```bash
|
|
98
|
-
node dist/cli.js --token mcp_xxx:userId --
|
|
156
|
+
node dist/cli.js --token mcp_xxx:userId --verbose
|
|
99
157
|
```
|
|
100
158
|
|
|
101
159
|
Check logs for:
|
|
@@ -107,92 +165,19 @@ Check logs for:
|
|
|
107
165
|
### Common Issues
|
|
108
166
|
|
|
109
167
|
**Token validation fails:**
|
|
110
|
-
- Ensure your backend server is running on the specified base URL
|
|
111
168
|
- Verify the token format is correct: `mcp_xxx:userId`
|
|
112
|
-
-
|
|
169
|
+
- Confirm the backend MCP endpoints are reachable
|
|
170
|
+
- Check network connectivity from your environment to the API
|
|
113
171
|
|
|
114
172
|
**Resources not showing:**
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
- Check authentication headers are being sent correctly
|
|
173
|
+
- Ensure the MCP token has permissions for feedbacks and scan data
|
|
174
|
+
- Inspect backend logs for API errors
|
|
118
175
|
|
|
119
176
|
**IDE not connecting:**
|
|
120
177
|
- Rebuild the project after code changes: `npm run build`
|
|
121
178
|
- Restart your IDE after updating the config
|
|
122
179
|
- Check IDE logs for MCP connection errors
|
|
123
|
-
- Verify the absolute path to `dist/cli.js` is correct
|
|
124
|
-
|
|
125
|
-
## Production Usage
|
|
126
|
-
|
|
127
|
-
### Command Line
|
|
128
|
-
|
|
129
|
-
```bash
|
|
130
|
-
rectify-mcp --token mcp_xxx:userId
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
### IDE Configuration
|
|
134
|
-
|
|
135
|
-
Copy just the top-level `rectify` block (do not wrap in `mcpServers` unless your IDE requires it):
|
|
136
|
-
|
|
137
|
-
```json
|
|
138
|
-
{
|
|
139
|
-
"rectify": {
|
|
140
|
-
"command": "npx",
|
|
141
|
-
"args": ["-y", "@rectify-so/mcp", "--token", "mcp_xxx:userId"]
|
|
142
|
-
}
|
|
143
|
-
}
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
#### Claude Desktop
|
|
147
|
-
|
|
148
|
-
Add to Claude Desktop config:
|
|
149
|
-
|
|
150
|
-
**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`
|
|
151
|
-
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
152
|
-
|
|
153
|
-
```json
|
|
154
|
-
{
|
|
155
|
-
"mcpServers": {
|
|
156
|
-
"rectify": {
|
|
157
|
-
"command": "npx",
|
|
158
|
-
"args": [
|
|
159
|
-
"-y",
|
|
160
|
-
"@rectify-so/mcp-server",
|
|
161
|
-
"--enable-feedback",
|
|
162
|
-
"--enable-scan",
|
|
163
|
-
"--ide", "claude"
|
|
164
|
-
],
|
|
165
|
-
"env": {
|
|
166
|
-
"RECTIFY_TOKEN": "mcp_xxx:userId"
|
|
167
|
-
}
|
|
168
|
-
}
|
|
169
|
-
}
|
|
170
|
-
}
|
|
171
|
-
```
|
|
172
|
-
|
|
173
|
-
#### Cursor
|
|
174
|
-
|
|
175
|
-
Add to Cursor settings:
|
|
176
|
-
|
|
177
|
-
```json
|
|
178
|
-
{
|
|
179
|
-
"mcp.servers": {
|
|
180
|
-
"rectify": {
|
|
181
|
-
"command": "npx",
|
|
182
|
-
"args": [
|
|
183
|
-
"-y",
|
|
184
|
-
"@rectify-so/mcp-server",
|
|
185
|
-
"--enable-feedback",
|
|
186
|
-
"--enable-scan",
|
|
187
|
-
"--ide", "cursor"
|
|
188
|
-
],
|
|
189
|
-
"env": {
|
|
190
|
-
"RECTIFY_TOKEN": "mcp_xxx:userId"
|
|
191
|
-
}
|
|
192
|
-
}
|
|
193
|
-
}
|
|
194
|
-
}
|
|
195
|
-
```
|
|
180
|
+
- Verify the absolute path to `dist/cli.js` is correct when running locally
|
|
196
181
|
|
|
197
182
|
## Options
|
|
198
183
|
|
package/dist/constants.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,EAAE,MAAiC,CAAA"}
|
package/dist/constants.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export const BASE_URL = '
|
|
1
|
+
export const BASE_URL = 'https://api.rectify.so';
|
|
2
2
|
//# sourceMappingURL=constants.js.map
|
package/dist/constants.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAW,
|
|
1
|
+
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAW,wBAAwB,CAAA"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rectify-so/mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "Rectify MCP Server for IDE integration",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|
|
@@ -10,7 +10,8 @@
|
|
|
10
10
|
"scripts": {
|
|
11
11
|
"build": "tsc",
|
|
12
12
|
"dev": "cross-env NODE_ENV=development tsx src/cli.ts",
|
|
13
|
-
"start": "node dist/cli.js"
|
|
13
|
+
"start": "node dist/cli.js",
|
|
14
|
+
"deploy": "npm publish --access=public"
|
|
14
15
|
},
|
|
15
16
|
"homepage": "https://app.rectify.so",
|
|
16
17
|
"dependencies": {
|