contextforge-mcp 0.1.76 → 0.1.77

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 (4) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +166 -91
  3. package/dist/index.js +1 -1
  4. package/package.json +21 -5
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Alfredo Izquierdo
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,26 +1,41 @@
1
- # ContextForge MCP Server
1
+ # ContextForge MCP — Persistent Memory for Claude, Cursor & Copilot
2
2
 
3
- Intelligent contextual memory system for AI-powered development. Store and retrieve knowledge across conversations, perfect for Claude Desktop and Claude Code.
3
+ [![npm version](https://img.shields.io/npm/v/contextforge-mcp.svg)](https://www.npmjs.com/package/contextforge-mcp)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+ [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org)
6
+
7
+ > Give Claude Code, Cursor, and GitHub Copilot **persistent memory across sessions** via the Model Context Protocol (MCP). Stop re-explaining your project every time.
8
+
9
+ ContextForge MCP is an open-source MCP server that connects your AI coding assistants to **long-term, searchable memory**. Decisions, architecture notes, debugging context, and project knowledge stay available across every session — across every tool that supports MCP.
10
+
11
+ - 🧠 **Persistent memory** — your AI remembers everything across sessions, days, and weeks
12
+ - 🔍 **Semantic search** — find knowledge by meaning, not keywords
13
+ - 🔗 **One memory, every tool** — Claude Code, Cursor, Copilot, Claude Desktop, Windsurf
14
+ - 🐙 **Git integration** — sync commits and PRs automatically
15
+ - ✅ **Task tracking** — issues, assignments, and project status
16
+ - 👥 **Team collaboration** — share projects and memory with your team
17
+ - 🆓 **Free tier** — get started without a credit card
18
+
19
+ ---
4
20
 
5
21
  ## Quick Start
6
22
 
7
- ### Installation
23
+ ### 1. Install
8
24
 
9
25
  ```bash
10
26
  npm install -g contextforge-mcp
11
27
  ```
12
28
 
13
- ### Get Your API Key
29
+ ### 2. Get your API key
14
30
 
15
31
  1. Go to **[contextforge.dev](https://contextforge.dev)**
16
- 2. Sign up for a free account
17
- 3. Navigate to Settings → API Keys
18
- 4. Click "Generate API Key"
19
- 5. Copy your key (starts with `cf_`)
32
+ 2. Sign up (free tier available)
33
+ 3. Settings → API Keys → **Generate API Key**
34
+ 4. Copy your key (starts with `cf_`)
20
35
 
21
- ### Configuration
36
+ ### 3. Connect to your AI tool
22
37
 
23
- #### For Claude Desktop
38
+ #### Claude Desktop
24
39
 
25
40
  Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
26
41
 
@@ -37,9 +52,9 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
37
52
  }
38
53
  ```
39
54
 
40
- **Restart Claude Desktop** and start using your memory!
55
+ Restart Claude Desktop.
41
56
 
42
- #### For Claude Code (CLI)
57
+ #### Claude Code (CLI)
43
58
 
44
59
  ```bash
45
60
  claude mcp add contextforge \
@@ -47,107 +62,131 @@ claude mcp add contextforge \
47
62
  -- contextforge-mcp
48
63
  ```
49
64
 
50
- Restart Claude Code and use `/mcp` to verify it's connected.
65
+ Restart Claude Code and run `/mcp` to verify it's connected.
66
+
67
+ #### Cursor
68
+
69
+ Add to your Cursor MCP settings:
70
+
71
+ ```json
72
+ {
73
+ "mcpServers": {
74
+ "contextforge": {
75
+ "command": "npx",
76
+ "args": ["contextforge-mcp"],
77
+ "env": {
78
+ "CONTEXTFORGE_API_KEY": "your-api-key-here"
79
+ }
80
+ }
81
+ }
82
+ }
83
+ ```
84
+
85
+ #### GitHub Copilot (VS Code)
86
+
87
+ Add to your Copilot MCP config:
88
+
89
+ ```json
90
+ {
91
+ "servers": {
92
+ "contextforge": {
93
+ "command": "npx",
94
+ "args": ["contextforge-mcp"],
95
+ "env": {
96
+ "CONTEXTFORGE_API_KEY": "your-api-key-here"
97
+ }
98
+ }
99
+ }
100
+ }
101
+ ```
51
102
 
52
103
  ---
53
104
 
54
105
  ## Available Tools
55
106
 
56
- ContextForge provides 3 types of functionality: **Knowledge Management**, **GitHub Integration**, and **Issue Tracking**.
107
+ ContextForge provides tools for **Knowledge Management**, **GitHub Integration**, **Issue Tracking**, and **Collaboration**.
57
108
 
58
109
  ### Knowledge Management
59
110
 
60
- Store, search, and organize your knowledge.
61
-
62
- | Tool | Description | Example |
63
- |------|-------------|---------|
64
- | `memory_ingest` | Save knowledge to memory | "Save this: our API uses JWT tokens" |
65
- | `memory_query` | Search your knowledge | "How do we handle authentication?" |
66
- | `memory_list_items` | List all stored items | "Show my saved items" |
67
- | `memory_delete` | Remove specific items | "Delete the item about old API" |
68
- | `memory_ingest_batch` | Save multiple items at once | "Save these 5 code snippets" |
69
- | `memory_delete_batch` | Delete items by filter | "Delete all items tagged 'draft'" |
111
+ | Tool | Description |
112
+ |------|-------------|
113
+ | `memory_ingest` | Save knowledge to memory |
114
+ | `memory_query` | Search your knowledge semantically |
115
+ | `memory_list_items` | List all stored items |
116
+ | `memory_delete` | Remove specific items |
117
+ | `memory_ingest_batch` | Save multiple items at once |
118
+ | `memory_delete_batch` | Delete items by filter |
70
119
 
71
120
  ### Spaces & Projects
72
121
 
73
- Organize your knowledge into workspaces.
74
-
75
- | Tool | Description | Example |
76
- |------|-------------|---------|
77
- | `memory_list_spaces` | List your spaces | "List my spaces" |
78
- | `memory_create_space` | Create a new space | "Create a space called Backend API" |
79
- | `memory_delete_space` | Delete a space | "Delete the old-project space" |
80
- | `memory_move_space` | Move space to project | "Move API space to Mobile project" |
81
- | `memory_list_projects` | List your projects | "Show my projects" |
82
- | `memory_create_project` | Create a new project | "Create project E-commerce App" |
83
- | `memory_delete_project` | Delete a project | "Delete the test project" |
84
- | `memory_link_project` | Link directory to project | "Link this folder to my project" |
85
- | `memory_unlink_project` | Unlink directory | "Unlink this folder" |
86
- | `memory_current_project` | Show linked project | "What project is linked here?" |
122
+ | Tool | Description |
123
+ |------|-------------|
124
+ | `memory_list_spaces` | List your spaces |
125
+ | `memory_create_space` | Create a new space |
126
+ | `memory_delete_space` | Delete a space |
127
+ | `memory_move_space` | Move space to project |
128
+ | `memory_list_projects` | List your projects |
129
+ | `memory_create_project` | Create a new project |
130
+ | `memory_delete_project` | Delete a project |
131
+ | `memory_link_project` | Link directory to project |
132
+ | `memory_unlink_project` | Unlink directory |
133
+ | `memory_current_project` | Show linked project |
87
134
 
88
135
  ### GitHub Integration
89
136
 
90
- Automatically sync commits and PRs from your repositories.
91
-
92
- | Tool | Description | Example |
93
- |------|-------------|---------|
94
- | `memory_git_connect` | Connect a GitHub repo | "Connect github.com/user/repo" |
95
- | `memory_git_list` | List connected repos | "Show my connected repos" |
96
- | `memory_git_activate` | Activate/deactivate webhook | "Activate the webhook" |
97
- | `memory_git_sync` | Import existing history | "Sync last 50 commits" |
98
- | `memory_git_commits` | List synced commits | "Show my recent commits" |
99
- | `memory_git_prs` | List synced PRs | "Show merged PRs this week" |
100
- | `memory_git_disconnect` | Disconnect a repo | "Disconnect the old repo" |
137
+ | Tool | Description |
138
+ |------|-------------|
139
+ | `memory_git_connect` | Connect a GitHub repo |
140
+ | `memory_git_list` | List connected repos |
141
+ | `memory_git_activate` | Activate/deactivate webhook |
142
+ | `memory_git_sync` | Import existing history |
143
+ | `memory_git_commits` | List synced commits |
144
+ | `memory_git_prs` | List synced PRs |
145
+ | `memory_git_disconnect` | Disconnect a repo |
101
146
 
102
147
  ### Issue Tracking
103
148
 
104
- Track tasks and collaborate with your team.
105
-
106
- | Tool | Description | Example |
107
- |------|-------------|---------|
108
- | `issues_list` | List your issues | "What's pending?" |
109
- | `issues_create` | Create a new issue | "Create issue: Fix login bug" |
110
- | `issues_start` | Mark as in progress | "Start working on abc123" |
111
- | `issues_resolve` | Mark as resolved | "Mark issue abc123 as done" |
112
- | `issues_resolve_by_name` | Resolve by title | "Resolve the login bug issue" |
113
- | `issues_assign` | Assign to collaborator | "Assign issue to john@example.com" |
114
- | `issues_what_next` | Get recommendation | "What should I work on next?" |
149
+ | Tool | Description |
150
+ |------|-------------|
151
+ | `issues_list` | List your issues |
152
+ | `issues_create` | Create a new issue |
153
+ | `issues_start` | Mark as in progress |
154
+ | `issues_resolve` | Mark as resolved |
155
+ | `issues_resolve_by_name` | Resolve by title |
156
+ | `issues_assign` | Assign to collaborator |
157
+ | `issues_what_next` | Get recommendation |
115
158
 
116
159
  ### Collaboration
117
160
 
118
- Share projects and work with your team.
119
-
120
- | Tool | Description | Example |
121
- |------|-------------|---------|
122
- | `project_share` | Share project by email | "Share project with alice@company.com" |
123
- | `collaborators_list` | List collaborators | "Who has access to this project?" |
161
+ | Tool | Description |
162
+ |------|-------------|
163
+ | `project_share` | Share project by email |
164
+ | `collaborators_list` | List collaborators |
124
165
 
125
166
  ### Snapshots & Export
126
167
 
127
- Backup and export your knowledge.
128
-
129
- | Tool | Description | Example |
130
- |------|-------------|---------|
131
- | `memory_snapshot_create` | Create a backup | "Create snapshot before refactoring" |
132
- | `memory_snapshot_list` | List all snapshots | "Show my backups" |
133
- | `memory_snapshot_restore` | Restore from backup | "Restore from yesterday's snapshot" |
134
- | `memory_snapshot_delete` | Delete a snapshot | "Delete old snapshot" |
135
- | `memory_export` | Export to JSON/MD/CSV | "Export my API space to markdown" |
136
- | `memory_import` | Import from file | "Import these notes" |
168
+ | Tool | Description |
169
+ |------|-------------|
170
+ | `memory_snapshot_create` | Create a backup |
171
+ | `memory_snapshot_list` | List all snapshots |
172
+ | `memory_snapshot_restore` | Restore from backup |
173
+ | `memory_snapshot_delete` | Delete a snapshot |
174
+ | `memory_export` | Export to JSON/MD/CSV |
175
+ | `memory_import` | Import from file |
137
176
 
138
177
  ### Utility
139
178
 
140
- | Tool | Description | Example |
141
- |------|-------------|---------|
142
- | `memory_stats` | View usage statistics | "Show my memory stats" |
143
- | `memory_relate` | Link two items | "Link these two items" |
144
- | `memory_help` | Show help | "How do I use ContextForge?" |
179
+ | Tool | Description |
180
+ |------|-------------|
181
+ | `memory_stats` | View usage statistics |
182
+ | `memory_relate` | Link two items |
183
+ | `memory_help` | Show help |
145
184
 
146
185
  ---
147
186
 
148
187
  ## Natural Language Examples
149
188
 
150
- You don't need to memorize commands. Just talk naturally:
189
+ You don't need to memorize commands — just talk naturally to your AI:
151
190
 
152
191
  ```
153
192
  # Knowledge
@@ -174,32 +213,68 @@ You don't need to memorize commands. Just talk naturally:
174
213
  | Variable | Required | Description |
175
214
  |----------|----------|-------------|
176
215
  | `CONTEXTFORGE_API_KEY` | Yes | Your API key from the dashboard |
216
+ | `CONTEXTFORGE_API_URL` | No | API endpoint (defaults to production) |
177
217
  | `CONTEXTFORGE_DEFAULT_SPACE` | No | Default space for operations |
178
218
 
179
219
  ---
180
220
 
221
+ ## How it works
222
+
223
+ ContextForge MCP is a thin client that translates Model Context Protocol tool calls into authenticated HTTP requests against the ContextForge API. Your knowledge is stored, indexed (semantic embeddings), and retrieved on the server side — the MCP client itself is stateless.
224
+
225
+ This means:
226
+ - **No infra to manage** — no local databases, no embeddings to run, no vector stores to maintain
227
+ - **Works everywhere your AI works** — same memory across Claude Code, Cursor, Copilot, etc.
228
+ - **Team collaboration** — shared projects sync in real time
229
+
230
+ ---
231
+
181
232
  ## Dashboard
182
233
 
183
- Manage your memories visually at **[contextforge.dev](https://contextforge.dev)**
234
+ Manage your memory visually at **[contextforge.dev](https://contextforge.dev)**:
184
235
 
185
236
  - View and organize your knowledge
186
237
  - Search and filter memories
187
- - Manage API keys
238
+ - Manage API keys and billing
188
239
  - Track issues and collaborate
189
240
  - Export and backup data
190
241
 
191
242
  ---
192
243
 
193
- ## Support
244
+ ## Development
194
245
 
195
- - [Documentation](https://contextforge.dev/docs)
196
- - [Report Issues](https://github.com/alfredoizdev/MCP-context-forge/issues)
197
- - Questions? Email: support@contextforge.app
246
+ ```bash
247
+ # Clone and install
248
+ git clone https://github.com/alfredoizdev/contextforge-mcp.git
249
+ cd contextforge-mcp
250
+ npm install
198
251
 
199
- ## License
252
+ # Build
253
+ npm run build
254
+
255
+ # Run tests
256
+ npm test
257
+
258
+ # Watch mode
259
+ npm run dev
260
+ ```
261
+
262
+ ---
263
+
264
+ ## Contributing
200
265
 
201
- MIT
266
+ Issues and pull requests are welcome at **[github.com/alfredoizdev/contextforge-mcp](https://github.com/alfredoizdev/contextforge-mcp)**.
202
267
 
203
268
  ---
204
269
 
205
- **Built with love by [Alfredo Izquierdo](https://github.com/alfredoizdev)**
270
+ ## Support
271
+
272
+ - 📖 [Documentation](https://contextforge.dev/docs)
273
+ - 🐛 [Report Issues](https://github.com/alfredoizdev/contextforge-mcp/issues)
274
+ - 💬 Questions: support@contextforge.app
275
+
276
+ ---
277
+
278
+ ## License
279
+
280
+ MIT © [Alfredo Izquierdo](https://github.com/alfredoizdev)
package/dist/index.js CHANGED
@@ -3223,7 +3223,7 @@ Remove the project link from this directory.
3223
3223
  - **Link projects** to keep context separate between codebases
3224
3224
 
3225
3225
  ## More Info
3226
- https://github.com/contextforge/contextforge-mcp
3226
+ https://github.com/alfredoizdev/contextforge-mcp
3227
3227
  `;
3228
3228
  return {
3229
3229
  content: [
package/package.json CHANGED
@@ -1,7 +1,8 @@
1
1
  {
2
2
  "name": "contextforge-mcp",
3
- "version": "0.1.76",
4
- "description": "Intelligent contextual memory MCP server for developers",
3
+ "version": "0.1.77",
4
+ "mcpName": "io.github.alfredoizdev/contextforge-mcp",
5
+ "description": "Persistent memory MCP server for Claude Code, Cursor, and GitHub Copilot. Give your AI assistants long-term memory via the Model Context Protocol.",
5
6
  "type": "module",
6
7
  "main": "./dist/index.js",
7
8
  "types": "./dist/index.d.ts",
@@ -11,7 +12,8 @@
11
12
  },
12
13
  "files": [
13
14
  "dist",
14
- "README.md"
15
+ "README.md",
16
+ "LICENSE"
15
17
  ],
16
18
  "scripts": {
17
19
  "build": "tsc",
@@ -38,13 +40,27 @@
38
40
  },
39
41
  "keywords": [
40
42
  "mcp",
43
+ "mcp-server",
44
+ "model-context-protocol",
41
45
  "memory",
46
+ "persistent-memory",
42
47
  "context",
43
48
  "ai",
44
49
  "claude",
45
- "knowledge-management"
50
+ "claude-code",
51
+ "cursor",
52
+ "copilot",
53
+ "knowledge-management",
54
+ "ai-agent-memory"
46
55
  ],
47
56
  "author": "Alfredo Izquierdo",
48
57
  "license": "MIT",
49
- "homepage": "https://contextforge.dev"
58
+ "homepage": "https://contextforge.dev",
59
+ "repository": {
60
+ "type": "git",
61
+ "url": "git+https://github.com/alfredoizdev/contextforge-mcp.git"
62
+ },
63
+ "bugs": {
64
+ "url": "https://github.com/alfredoizdev/contextforge-mcp/issues"
65
+ }
50
66
  }