Claude Writer's Aid MCP

Instructions

Implementation Reference

• src/tools/WriterToolHandlers.ts:287-291 (handler)

  MCP tool handler function for 'get_writing_stats' that extracts scope from input args and delegates to WritersAid.getStats method.

  private async getWritingStats(args: Record<string, unknown>) {
    const scope = args.scope as string | undefined;
  
    return this.writersAid.getStats({ scope });
  }

• src/WritersAid.ts:270-285 (helper)

  Core helper method in WritersAid that computes project writing statistics by querying storage for all files and aggregating word counts, file counts, averages, and per-file details.

  async getStats(_options?: { scope?: string }) {
    const files = await this.storage.getAllFiles();
    const totalWords = files.reduce((sum, f) => sum + (f.word_count || 0), 0);
    const totalFiles = files.length;
  
    return {
      totalWords,
      totalFiles,
      averageWordsPerFile: totalFiles > 0 ? Math.round(totalWords / totalFiles) : 0,
      files: files.map((f) => ({
        path: f.file_path,
        words: f.word_count || 0,
        lastModified: f.last_modified,
      })),
    };
  }

• src/tools/WriterToolDefinitions.ts:275-290 (schema)

  JSON schema definition for the get_writing_stats tool, including input properties and descriptions.

  {
    name: "get_writing_stats",
    description: "Overall project statistics",
    inputSchema: {
      type: "object",
      properties: {
        project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
        scope: { type: "string", description: "File scope pattern" },
        breakdown_by: {
          type: "string",
          enum: ["chapter", "date", "tag"],
          description: "Breakdown method",
        },
      },
    },
  },

• src/index.ts:73-75 (registration)

  MCP server registration for listing available tools, which includes the get_writing_stats tool schema from writerToolDefinitions.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: writerToolDefinitions,
  }));

• src/index.ts:86-91 (registration)

  MCP server tool call handler registration that instantiates WritersAid and WriterToolHandlers, then dispatches to the specific tool handler via handleTool.

  const writersAid = new WritersAid({ projectPath });
  const handlers = new WriterToolHandlers(writersAid);
  
  // Call the tool
  const result = await handlers.handleTool(name, args || {});