get_project_status
Check a Trace MCP project's configuration, cache state, and validation results to monitor schema consistency between data producers and consumers.
Instructions
Get the status of a trace project including config, cache state, and last validation result.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectDir | Yes | Root directory with .trace-mcp config |
Implementation Reference
- src/index.ts:693-740 (handler)Main execution logic for the get_project_status tool. Parses input, loads the TraceProject, checks if it exists, retrieves configuration and watcher status, and returns a detailed JSON status report.
case 'get_project_status': { const input = GetProjectStatusInput.parse(args); log(`Getting project status for: ${input.projectDir}`); const project = loadProject(input.projectDir); if (!project.exists()) { return { content: [{ type: 'text', text: JSON.stringify({ success: false, exists: false, error: `No trace project found at ${input.projectDir}`, }, null, 2), }], }; } const config = project.config; const activeWatchers = listActiveWatchers(); const isWatching = activeWatchers.includes(project.rootDir); let watcherStatus = null; if (isWatching) { const watcher = getWatcher(project); watcherStatus = watcher.getStatus(); } return { content: [{ type: 'text', text: JSON.stringify({ success: true, exists: true, projectDir: project.rootDir, traceDir: project.traceDir, config, isWatching, watcherStatus, paths: { producer: project.producerPath, consumer: project.consumerPath, }, }, null, 2), }], }; } - src/index.ts:109-111 (schema)Zod schema for validating the input to the get_project_status tool, requiring a projectDir string.
const GetProjectStatusInput = z.object({ projectDir: z.string().describe('Root directory with .trace-mcp config'), }); - src/index.ts:265-274 (registration)Registration of the get_project_status tool in the ListTools response, defining its name, description, and input schema.
name: 'get_project_status', description: 'Get the status of a trace project including config, cache state, and last validation result.', inputSchema: { type: 'object', properties: { projectDir: { type: 'string', description: 'Root directory with .trace-mcp config' }, }, required: ['projectDir'], }, },