project-mcp 1.4.2 → 3.0.0

package/README.md

@@ -218,25 +218,25 @@ Implement OAuth 2.0 authentication flow...
 │  1. promote_task(task_id: "AUTH-001")                       │
 │     → Creates todos/AUTH-001.md from BACKLOG.md             │
 └─────────────────────┬───────────────────────────────────────┘
-                      │
-                      ▼
+                     │
+                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  2. get_next_task()                                         │
 │     → Returns AUTH-001 (dependencies met, highest priority) │
 └─────────────────────┬───────────────────────────────────────┘
-                      │
-                      ▼
+                     │
+                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  3. update_task(id: "AUTH-001", status: "in_progress")      │
 │     → Agent works on the task                               │
 └─────────────────────┬───────────────────────────────────────┘
-                      │
-                      ▼
+                     │
+                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  4. update_task(id: "AUTH-001", status: "done")             │
 └─────────────────────┬───────────────────────────────────────┘
-                      │
-                      ▼
+                     │
+                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  5. archive_task(task_id: "AUTH-001")                       │
 │     → Moves to archive/, keeps todos/ small                 │
@@ -404,7 +404,7 @@ Returns tasks sorted by priority where all dependencies are complete.
 	"arguments": {
 		"project_name": "My App",
 		"project_description": "A web application for task management"
-	}
+  }
 }
 ```
 

package/package.json

@@ -1,79 +1,79 @@
 {
-  "name": "project-mcp",
-	"version": "1.4.2",
-  "description": "Intent-based MCP server for project documentation search. Maps natural language queries to the right sources automatically—no configuration needed. The standard for AI agent documentation search.",
-  "type": "module",
-  "main": "src/index.js",
-  "bin": {
-    "project-mcp": "src/index.js"
-  },
-  "scripts": {
-    "start": "node src/index.js",
-    "test": "node --test test/*.test.js",
-    "lint": "node --check src/index.js",
-    "format": "prettier --write \"**/*.{js,md,json}\"",
-    "format:check": "prettier --check \"**/*.{js,md,json}\"",
-    "prepublishOnly": "npm run lint && npm test"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "mcp-server",
-    "documentation",
-    "documentation-search",
-    "docs-search",
-    "search",
-    "fuzzy-search",
-    "semantic-search",
-    "markdown",
-    "markdown-search",
-    "project-documentation",
-    "project-management",
-    "intent-based-search",
-    "intent-mapping",
-    "ai-agent",
-    "ai-assistant",
-    "claude",
-    "cursor",
-    "anthropic",
-    "ai-tools",
-    "developer-tools",
-    "documentation-tools",
-    "knowledge-base",
-    "project-knowledge",
-    "operational-truth",
-    "reference-documentation",
-    "fuse.js",
-    "natural-language",
-    "nlp",
-    "zero-config",
-    "automatic-indexing"
-  ],
-  "author": "",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/pouyanafisi/project-mcp.git"
-  },
-  "bugs": {
-    "url": "https://github.com/pouyanafisi/project-mcp/issues"
-  },
-  "homepage": "https://github.com/pouyanafisi/project-mcp#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4",
-    "fuse.js": "^7.0.0",
-    "gray-matter": "^4.0.3",
-    "mime-types": "^2.1.35"
-  },
-  "devDependencies": {
-    "prettier": "^3.7.4"
-  },
-  "files": [
-    "src/",
-    "README.md",
-    "LICENSE"
-  ]
+	"name": "project-mcp",
+	"version": "3.0.0",
+	"description": "Intent-based MCP server for project documentation search. Maps natural language queries to the right sources automatically—no configuration needed. The standard for AI agent documentation search.",
+	"type": "module",
+	"main": "src/index.js",
+	"bin": {
+		"project-mcp": "src/index.js"
+	},
+	"scripts": {
+		"start": "node src/index.js",
+		"test": "node --test test/*.test.js",
+		"lint": "node --check src/index.js",
+		"format": "prettier --write \"**/*.{js,md,json}\"",
+		"format:check": "prettier --check \"**/*.{js,md,json}\"",
+		"prepublishOnly": "npm run lint && npm test"
+	},
+	"keywords": [
+		"mcp",
+		"model-context-protocol",
+		"mcp-server",
+		"documentation",
+		"documentation-search",
+		"docs-search",
+		"search",
+		"fuzzy-search",
+		"semantic-search",
+		"markdown",
+		"markdown-search",
+		"project-documentation",
+		"project-management",
+		"intent-based-search",
+		"intent-mapping",
+		"ai-agent",
+		"ai-assistant",
+		"claude",
+		"cursor",
+		"anthropic",
+		"ai-tools",
+		"developer-tools",
+		"documentation-tools",
+		"knowledge-base",
+		"project-knowledge",
+		"operational-truth",
+		"reference-documentation",
+		"fuse.js",
+		"natural-language",
+		"nlp",
+		"zero-config",
+		"automatic-indexing"
+	],
+	"author": "",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/pouyanafisi/project-mcp.git"
+	},
+	"bugs": {
+		"url": "https://github.com/pouyanafisi/project-mcp/issues"
+	},
+	"homepage": "https://github.com/pouyanafisi/project-mcp#readme",
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.0.4",
+		"fuse.js": "^7.0.0",
+		"gray-matter": "^4.0.3",
+		"mime-types": "^2.1.35"
+	},
+	"devDependencies": {
+		"prettier": "^3.7.4"
+	},
+	"files": [
+		"src/",
+		"README.md",
+		"LICENSE"
+	]
 }

package/src/prompts/definitions.js

@@ -1,21 +1,40 @@
 /**
  * Prompt definitions for the MCP server.
  * These prompts help agents discover and use tools appropriately.
+ *
+ * NAMING CONVENTION: Use snake_case matching tool names where there's a 1:1 mapping.
+ * For multi-tool prompts, use descriptive snake_case names.
  */
 
+/**
+ * Mapping of prompts to the tools they invoke.
+ * Used for validation and documentation.
+ * @type {Record<string, string[]>}
+ */
+export const promptToolMapping = {
+	project_overview: ['check_project_state', 'search_project', 'list_tasks'],
+	get_next_task: ['get_next_task'],
+	init_project: ['init_project'],
+	import_tasks: ['import_tasks'],
+	promote_task: ['promote_task', 'update_task'],
+	lint_project: ['lint_project_docs'],
+	list_tasks: ['list_tasks'],
+	update_task: ['update_task'],
+};
+
 /**
  * All available prompts
  * @type {Array<{name: string, description: string, arguments: Array}>}
  */
 export const prompts = [
 	{
-		name: 'project-overview',
+		name: 'project_overview',
 		description:
 			'Get an overview of the project, its status, and what work is in progress. Use when user asks "tell me about this project", "what is this project", "project status", or "what\'s going on".',
 		arguments: [],
 	},
 	{
-		name: 'what-should-i-work-on',
+		name: 'get_next_task',
 		description:
 			'Find the next task to work on based on priorities and dependencies. Use when user asks "what should I do", "what\'s next", "what to work on", or "next task".',
 		arguments: [
@@ -27,7 +46,7 @@ export const prompts = [
 		],
 	},
 	{
-		name: 'start-new-project',
+		name: 'init_project',
 		description:
 			'Initialize a new project with standard documentation structure. Use when user says "start a project", "new project", "initialize project", or "set up project docs".',
 		arguments: [
@@ -44,9 +63,9 @@ export const prompts = [
 		],
 	},
 	{
-		name: 'import-plan-to-backlog',
+		name: 'import_tasks',
 		description:
-			'Import tasks from a roadmap or plan document into the backlog. Use when user says "import tasks", "add tasks from roadmap", "populate backlog", or "convert plan to tasks".',
+			'Import tasks from a roadmap or plan document into BACKLOG.md. Use when user says "import tasks", "add tasks from roadmap", "populate backlog", or "convert plan to tasks".',
 		arguments: [
 			{
 				name: 'source_file',
@@ -61,7 +80,7 @@ export const prompts = [
 		],
 	},
 	{
-		name: 'start-working-on-task',
+		name: 'promote_task',
 		description:
 			'Promote a task from backlog to active work. Use when user says "start task", "work on X", "begin task", or "activate task".',
 		arguments: [
@@ -73,7 +92,7 @@ export const prompts = [
 		],
 	},
 	{
-		name: 'check-project-health',
+		name: 'lint_project',
 		description:
 			'Validate project documentation and check for issues. Use when user says "lint project", "check project files", "validate docs", or "project health check".',
 		arguments: [
@@ -85,7 +104,7 @@ export const prompts = [
 		],
 	},
 	{
-		name: 'list-all-tasks',
+		name: 'list_tasks',
 		description:
 			'Show all tasks with their status. Use when user asks "show tasks", "list todos", "what tasks exist", or "task list".',
 		arguments: [
@@ -97,7 +116,7 @@ export const prompts = [
 		],
 	},
 	{
-		name: 'update-task-status',
+		name: 'update_task',
 		description:
 			'Update the status of a task. Use when user says "mark task done", "complete task", "task is blocked", or "start task".',
 		arguments: [
@@ -114,3 +133,20 @@ export const prompts = [
 		],
 	},
 ];
+
+/**
+ * Get all prompt names
+ * @returns {string[]}
+ */
+export function getPromptNames() {
+	return prompts.map((p) => p.name);
+}
+
+/**
+ * Get tools used by a prompt
+ * @param {string} promptName
+ * @returns {string[]}
+ */
+export function getToolsForPrompt(promptName) {
+	return promptToolMapping[promptName] || [];
+}

package/src/prompts/index.js

@@ -6,7 +6,7 @@ import {
 	ListPromptsRequestSchema,
 	GetPromptRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
-import { prompts } from './definitions.js';
+import { prompts, promptToolMapping } from './definitions.js';
 
 /**
  * Generate messages for a prompt that guide the agent to use the right tools
@@ -16,7 +16,7 @@ import { prompts } from './definitions.js';
  */
 function generatePromptMessages(promptName, args) {
 	const messages = {
-		'project-overview': [
+		project_overview: [
 			{
 				role: 'user',
 				content: {
@@ -29,7 +29,7 @@ function generatePromptMessages(promptName, args) {
 				},
 			},
 		],
-		'what-should-i-work-on': [
+		get_next_task: [
 			{
 				role: 'user',
 				content: {
@@ -45,7 +45,7 @@ Then explain what the task involves and any context from the project.`,
 				},
 			},
 		],
-		'start-new-project': [
+		init_project: [
 			{
 				role: 'user',
 				content: {
@@ -65,7 +65,7 @@ This will create the standard .project/ structure with:
 				},
 			},
 		],
-		'import-plan-to-backlog': [
+		import_tasks: [
 			{
 				role: 'user',
 				content: {
@@ -82,7 +82,7 @@ Tasks will be added to BACKLOG.md, not as individual files.`,
 				},
 			},
 		],
-		'start-working-on-task': [
+		promote_task: [
 			{
 				role: 'user',
 				content: {
@@ -97,7 +97,7 @@ Then use \`update_task\` to set status to "in_progress".`,
 				},
 			},
 		],
-		'check-project-health': [
+		lint_project: [
 			{
 				role: 'user',
 				content: {
@@ -117,7 +117,7 @@ This validates:
 				},
 			},
 		],
-		'list-all-tasks': [
+		list_tasks: [
 			{
 				role: 'user',
 				content: {
@@ -130,7 +130,7 @@ This shows tasks organized by status with counts and a summary dashboard.`,
 				},
 			},
 		],
-		'update-task-status': [
+		update_task: [
 			{
 				role: 'user',
 				content: {
@@ -160,6 +160,24 @@ Valid statuses: todo, in_progress, blocked, review, done`,
 	);
 }
 
+/**
+ * Get all message handler keys (for testing)
+ * @returns {string[]}
+ */
+export function getMessageHandlerKeys() {
+	const messages = {
+		project_overview: true,
+		get_next_task: true,
+		init_project: true,
+		import_tasks: true,
+		promote_task: true,
+		lint_project: true,
+		list_tasks: true,
+		update_task: true,
+	};
+	return Object.keys(messages);
+}
+
 /**
  * Setup prompt handlers on the server
  * @param {Server} server - MCP server instance
@@ -189,4 +207,4 @@ export function setupPrompts(server) {
 	});
 }
 
-export { prompts };
+export { prompts, promptToolMapping };