Local Utilities MCP Server

Implementation Reference

• src/mcp/think.ts:67-82 (registration)

  Registers the 'think' MCP tool: defines input schema, handler logic to record thought with timestamp in closure-based state, and returns success response.

  server.tool(
    "think",
    { thought: z.string().min(1, "Thought cannot be empty").describe("The thought content to record") },
    async ({ thought }) => {
      thoughts.push({
        timestamp: new Date().toISOString(),
        content: thought
      });
      return {
        content: [{
          type: "text",
          text: "Thought recorded successfully"
        }]
      };
    }
  );

• src/mcp/think.ts:70-81 (handler)

  The core handler function for the 'think' tool that appends the user-provided thought to an internal array with a timestamp and responds with a text confirmation.

  async ({ thought }) => {
    thoughts.push({
      timestamp: new Date().toISOString(),
      content: thought
    });
    return {
      content: [{
        type: "text",
        text: "Thought recorded successfully"
      }]
    };
  }

• src/mcp/think.ts:69-69 (schema)

  Zod schema for 'think' tool input: requires a non-empty string 'thought'.

  { thought: z.string().min(1, "Thought cannot be empty").describe("The thought content to record") },

• src/index.ts:25-25 (registration)

  Top-level call to register the 'think' tool (and others) on the MCP server instance.

  registerThinkTool(server);

• src/mcp/think.ts:20-60 (helper)

  Supporting class with methods to manage thoughts (add, retrieve, clear, stats), maintained for testing but registration uses closure state instead.

  export class ThinkToolInternalLogic {
    thoughts: Thought[] = []; // Make public for test access if needed, or add methods
  
    addThought(content: string): void {
      this.thoughts.push({
        timestamp: new Date().toISOString(),
        content
      });
    }
  
    getAllThoughts(): Thought[] {
      return [...this.thoughts];
    }
  
    clearThoughts(): void {
      this.thoughts = [];
    }
  
    getThoughtStats(): ThoughtStats {
      const totalThoughts = this.thoughts.length;
      
      if (totalThoughts === 0) {
        return {
          totalThoughts: 0,
          averageLength: 0,
          oldestThought: null,
          newestThought: null
        };
      }
  
      const averageLength = this.thoughts.reduce((acc, thought) => 
        acc + thought.content.length, 0) / totalThoughts;
  
      return {
        totalThoughts,
        averageLength: parseFloat(averageLength.toFixed(2)), // Keep formatted
        oldestThought: this.thoughts[0].timestamp,
        newestThought: this.thoughts[this.thoughts.length - 1].timestamp
      };
    }
  }