setupHandlers() — mcp Function Reference

Architecture documentation for the setupHandlers() function in server.ts from the mcp codebase.

Function typescript McpServer Configuration calls 4 called by 1

Entity Profile

McpServer→ Configuration→ setupHandlers() — mcp Function Reference

Dependency Diagram

graph TD
  6471f5ca_fcb9_6e5d_af84_17b245dc7c0f["setupHandlers()"]
  50dc88e1_e79b_8a97_364b_4502057dd58f["Server"]
  6471f5ca_fcb9_6e5d_af84_17b245dc7c0f -->|defined in| 50dc88e1_e79b_8a97_364b_4502057dd58f
  65787d30_1025_d531_cde5_ded3572607bd["constructor()"]
  65787d30_1025_d531_cde5_ded3572607bd -->|calls| 6471f5ca_fcb9_6e5d_af84_17b245dc7c0f
  5b58088c_d9af_5bc6_19ab_1fff095079b9["has()"]
  6471f5ca_fcb9_6e5d_af84_17b245dc7c0f -->|calls| 5b58088c_d9af_5bc6_19ab_1fff095079b9
  4e1e5a38_002c_8f16_1767_0260a7001d5e["set()"]
  6471f5ca_fcb9_6e5d_af84_17b245dc7c0f -->|calls| 4e1e5a38_002c_8f16_1767_0260a7001d5e
  2ef71e67_fa6d_b33f_d005_85a400698718["get()"]
  6471f5ca_fcb9_6e5d_af84_17b245dc7c0f -->|calls| 2ef71e67_fa6d_b33f_d005_85a400698718
  b0737d71_130b_01b2_dbd7_14cb5f04946b["handler()"]
  6471f5ca_fcb9_6e5d_af84_17b245dc7c0f -->|calls| b0737d71_130b_01b2_dbd7_14cb5f04946b
  style 6471f5ca_fcb9_6e5d_af84_17b245dc7c0f fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/server.ts lines 106–137

  private setupHandlers() {
    const allTools = [
      overviewTool,
      symbolContextTool,
    ];

    // Create a map for quick handler lookup
    const toolMap = new Map<string, typeof allTools[0]>();
    for (const t of allTools) {
      if (toolMap.has(t.tool.name)) {
        throw new Error(`Duplicate tool name: ${t.tool.name}`);
      }
      toolMap.set(t.tool.name, t);
    }

    this.server.server.setRequestHandler(ListToolsRequestSchema, async () => {
      return {
        tools: allTools.map(t => t.tool),
      };
    });

    this.server.server.setRequestHandler(CallToolRequestSchema, async (request) => {
      const { name, arguments: args } = request.params;

      const tool = toolMap.get(name);
      if (tool) {
        return tool.handler(this.client, args, this.defaultWorkdir);
      }

      throw new Error(`Unknown tool: ${name}`);
    });
  }