SpiderFoot MCP Server

Instructions

Implementation Reference

• src/index.ts:45-49 (registration)

  Registration of the 'spiderfoot_modules' MCP tool. The handler fetches modules via the SpiderfootClient and returns JSON.

  server.registerTool(
    'spiderfoot_modules',
    { title: 'Modules', description: 'List available SpiderFoot modules.', inputSchema: {} },
    async () => ({ content: [{ type: 'text', text: JSON.stringify(await sf.modules()) }] })
  );

• src/spiderfootClient.ts:29-32 (handler)

  Core handler function in SpiderfootClient that performs HTTP GET /modules to retrieve the list of available SpiderFoot modules.

  async modules() {
    const { data } = await this.http.get('/modules');
    return data;
  }

• src/index-http.ts:29-33 (registration)

  Registration of the 'spiderfoot_modules' MCP tool in the HTTP server variant. Identical to stdio version.

  server.registerTool(
    'spiderfoot_modules',
    { title: 'Modules', description: 'List available SpiderFoot modules.', inputSchema: {} },
    async () => ({ content: [{ type: 'text', text: JSON.stringify(await sf.modules()) }] })
  );

• src/spiderfootClient.ts:92-97 (helper)

  Helper function to create the SpiderfootClient instance from environment variables, used by the tool handler.

  export function makeSpiderfootClientFromEnv() {
    const baseUrl = process.env.SPIDERFOOT_BASE_URL || 'http://127.0.0.1:5001';
    const username = process.env.SPIDERFOOT_USER;
    const password = process.env.SPIDERFOOT_PASS;
    return new SpiderfootClient({ baseUrl, username, password });
  }