@context-forge/mcp 0.6.0 → 0.6.2
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/dist/index.js
CHANGED
|
@@ -13,6 +13,7 @@ import { registerWorkflowTools } from './tools/workflowTools.js';
|
|
|
13
13
|
import { registerWorktreeTools } from './tools/worktreeTools.js';
|
|
14
14
|
import { registerVersionTool } from './tools/versionTool.js';
|
|
15
15
|
import { registerGuideTools } from './tools/guideTools.js';
|
|
16
|
+
import { registerAgentGuideTool } from './tools/agentGuideTool.js';
|
|
16
17
|
const require = createRequire(import.meta.url);
|
|
17
18
|
const { version: SERVER_VERSION } = require('../package.json');
|
|
18
19
|
const SERVER_NAME = 'context-forge-mcp';
|
|
@@ -24,6 +25,7 @@ async function main() {
|
|
|
24
25
|
name: SERVER_NAME,
|
|
25
26
|
version: SERVER_VERSION,
|
|
26
27
|
});
|
|
28
|
+
registerAgentGuideTool(server);
|
|
27
29
|
registerProjectTools(server);
|
|
28
30
|
registerContextTools(server);
|
|
29
31
|
registerStateTools(server);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,qEAAqE;AACrE,2CAA2C;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,qEAAqE;AACrE,2CAA2C;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AACtF,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,kBAAkB,OAAO,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agentGuideTool.d.ts","sourceRoot":"","sources":["../../src/tools/agentGuideTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsEpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAc9D"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
const AGENT_GUIDE = `# Context Forge — Agent Guide
|
|
2
|
+
|
|
3
|
+
Context Forge manages AI-assisted development projects through structured phases:
|
|
4
|
+
Concept → Architecture → Slice Planning → Slice Design → Task Breakdown → Implementation
|
|
5
|
+
|
|
6
|
+
Call this tool first to understand what's available and how to use it.
|
|
7
|
+
|
|
8
|
+
## Quick Start
|
|
9
|
+
|
|
10
|
+
1. **project_list** — See all registered projects. Find the one matching the user's current directory.
|
|
11
|
+
2. **project_get** — Get full details for a project (phase, active slice, task file, etc.).
|
|
12
|
+
3. **workflow_next** — Get the recommended next action with rationale and suggested command.
|
|
13
|
+
4. **context_build** — Generate a structured context prompt for the current project state.
|
|
14
|
+
|
|
15
|
+
## Tool Categories
|
|
16
|
+
|
|
17
|
+
### Project (start here)
|
|
18
|
+
- **project_list** — List all projects (use to find project by path)
|
|
19
|
+
- **project_get** — Full project details with introspection
|
|
20
|
+
- **project_create** — Create a new project (name + path required)
|
|
21
|
+
- **project_update** — Update project fields
|
|
22
|
+
- **project_schema** — Show all available project fields and valid values
|
|
23
|
+
- **project_structure** — Show project directory structure
|
|
24
|
+
|
|
25
|
+
### Workflow (what to do next)
|
|
26
|
+
- **workflow_next** — Recommended next action based on project state
|
|
27
|
+
- **workflow_status** — Current phase, slice, and task progress
|
|
28
|
+
- **workflow_check** — Run consistency checks on project artifacts
|
|
29
|
+
- **workflow_future** — Consolidated future work across slice plans
|
|
30
|
+
|
|
31
|
+
### Context (build prompts)
|
|
32
|
+
- **context_build** — Assemble a full context prompt for an AI session
|
|
33
|
+
- **context_summarize** — Summarize project context
|
|
34
|
+
- **template_preview** — Preview a prompt template with variables
|
|
35
|
+
- **prompt_list** — List available prompt templates
|
|
36
|
+
- **prompt_get** — Get a specific prompt template
|
|
37
|
+
|
|
38
|
+
### Introspection (read project artifacts)
|
|
39
|
+
- **introspection_documents** — Detect documents for a slice index
|
|
40
|
+
- **introspection_frontmatter** — Parse YAML frontmatter from a document
|
|
41
|
+
- **introspection_slice_plan** — Parse a slice plan file
|
|
42
|
+
- **introspection_tasks** — Parse task files with completion state
|
|
43
|
+
- **introspection_future_work** — Future work items across plans
|
|
44
|
+
|
|
45
|
+
### Guides
|
|
46
|
+
- **guide_status** — Check if the AI project guide is installed
|
|
47
|
+
- **guide_install** — Install the methodology guide
|
|
48
|
+
- **guide_update** — Update to latest guide version
|
|
49
|
+
|
|
50
|
+
### Worktrees (parallel work in git worktrees)
|
|
51
|
+
- **worktree_list**, **worktree_get**, **worktree_init**, **worktree_update**, **worktree_rm**
|
|
52
|
+
|
|
53
|
+
### Configuration
|
|
54
|
+
- **config_list**, **config_get**, **config_set** — Manage settings (rarely needed)
|
|
55
|
+
|
|
56
|
+
### Meta
|
|
57
|
+
- **server_version** — Server name and version
|
|
58
|
+
- **storage_backup** — Create a versioned backup of project data
|
|
59
|
+
|
|
60
|
+
## Common Mistakes
|
|
61
|
+
|
|
62
|
+
- Do NOT start with config_list — configuration is rarely relevant to the user's task.
|
|
63
|
+
- Do NOT call project_update without the user asking to change something.
|
|
64
|
+
- Do NOT guess project IDs — call project_list first to find the right one.
|
|
65
|
+
- If the user says "what's next" or "what should I do", call workflow_next.
|
|
66
|
+
- If the user wants to start a session, call context_build for a full context prompt.
|
|
67
|
+
`;
|
|
68
|
+
export function registerAgentGuideTool(server) {
|
|
69
|
+
server.registerTool('agent_guide', {
|
|
70
|
+
title: 'Agent Guide',
|
|
71
|
+
description: 'How to use Context Forge tools. Call this first to understand available tools, common workflows, and what to avoid.',
|
|
72
|
+
inputSchema: {},
|
|
73
|
+
annotations: { readOnlyHint: true, openWorldHint: false },
|
|
74
|
+
}, async () => ({
|
|
75
|
+
content: [{ type: 'text', text: AGENT_GUIDE }],
|
|
76
|
+
}));
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=agentGuideTool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agentGuideTool.js","sourceRoot":"","sources":["../../src/tools/agentGuideTool.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkEnB,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,qHAAqH;QACvH,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KACxD,CAAC,CACH,CAAC;AACJ,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@context-forge/mcp",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.2",
|
|
4
4
|
"description": "MCP server for Context Forge — generates structured AI context prompts from project configuration and templates",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"dependencies": {
|
|
35
35
|
"@modelcontextprotocol/sdk": "^1.26.0",
|
|
36
36
|
"zod": "^4.1.5",
|
|
37
|
-
"@context-forge/core": "0.6.
|
|
37
|
+
"@context-forge/core": "0.6.2"
|
|
38
38
|
},
|
|
39
39
|
"devDependencies": {
|
|
40
40
|
"@types/node": "^25.3.0",
|