@context-forge/mcp 0.19.26 → 0.19.28

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
@@ -16,6 +16,7 @@ import { registerVersionTool } from './tools/versionTool.js';
16
16
  import { registerGuideTools } from './tools/guideTools.js';
17
17
  import { registerAgentOnboardTool } from './tools/agentOnboardTool.js';
18
18
  import { registerAgentQuickstartTool } from './tools/agentQuickstartTool.js';
19
+ import { SERVER_INSTRUCTIONS } from './serverInstructions.js';
19
20
  const require = createRequire(import.meta.url);
20
21
  const { version: SERVER_VERSION } = require('../package.json');
21
22
  const SERVER_NAME = 'context-forge-mcp';
@@ -23,10 +24,7 @@ function log(message) {
23
24
  console.error(`[${SERVER_NAME}] ${message}`);
24
25
  }
25
26
  async function main() {
26
- const server = new McpServer({
27
- name: SERVER_NAME,
28
- version: SERVER_VERSION,
29
- });
27
+ const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, { instructions: SERVER_INSTRUCTIONS });
30
28
  // Registration order matters — some MCP clients truncate tool lists.
31
29
  // High-priority tools first to maximize usability on limited clients.
32
30
  registerAgentOnboardTool(server); // onboarding recipe for new projects
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Cross-tool guidance returned to MCP clients in the `instructions` field.
3
+ * Covers ordering, project resolution and recovery. Per-tool behavior belongs
4
+ * in the tool descriptions, not here.
5
+ */
6
+ export declare const SERVER_INSTRUCTIONS: string;
7
+ //# sourceMappingURL=serverInstructions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serverInstructions.d.ts","sourceRoot":"","sources":["../src/serverInstructions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAepB,CAAC"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Cross-tool guidance returned to MCP clients in the `instructions` field.
3
+ * Covers ordering, project resolution and recovery. Per-tool behavior belongs
4
+ * in the tool descriptions, not here.
5
+ */
6
+ export const SERVER_INSTRUCTIONS = [
7
+ 'Context Forge tracks AI-assisted project workflow: phases, slice plans, slice designs and task files.',
8
+ 'The `cf` CLI exposes the same operations; these tools exist so an agent does not have to shell out.',
9
+ '',
10
+ 'Project resolution: tools that take a project id match the current working directory against registered project and worktree paths when the id is omitted.',
11
+ '',
12
+ 'Ordering:',
13
+ '- Start with workflow_status or workflow_next to learn where the project is and what to do next. Run workflow_check when artifacts look inconsistent.',
14
+ '- Use introspection_* tools to read project artifacts rather than reading and parsing the files yourself.',
15
+ '- Call project_schema before project_update if you are unsure which fields exist.',
16
+ '',
17
+ 'Recovery:',
18
+ '- If no registered project matches the directory, call project_detect with its absolute path to see what is there, then follow agent_onboard to set the project up.',
19
+ '- If prompts or guides are missing, use guide_status, then guide_install or guide_update.',
20
+ '- Call storage_backup before bulk edits to project data.',
21
+ ].join('\n');
22
+ //# sourceMappingURL=serverInstructions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serverInstructions.js","sourceRoot":"","sources":["../src/serverInstructions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,uGAAuG;IACvG,qGAAqG;IACrG,EAAE;IACF,4JAA4J;IAC5J,EAAE;IACF,WAAW;IACX,uJAAuJ;IACvJ,2GAA2G;IAC3G,mFAAmF;IACnF,EAAE;IACF,WAAW;IACX,qKAAqK;IACrK,2FAA2F;IAC3F,0DAA0D;CAC3D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@context-forge/mcp",
3
- "version": "0.19.26",
3
+ "version": "0.19.28",
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.19.26"
37
+ "@context-forge/core": "0.19.28"
38
38
  },
39
39
  "devDependencies": {
40
40
  "@types/node": "^25.3.0",