FinanceMCP

Instructions

Implementation Reference

• src/tools/fundManagerByName.ts:359-385 (handler)

  The main execution function for the 'fund_manager_by_name' tool. It fetches fund manager data from the TUSHARE API using the provided name and optional announcement date, processes and formats the response into a structured markdown output including personal info, managed funds, and statistics.

  export async function runFundManagerByName(args: { 
    name: string; 
    ann_date?: string; 
  }) {
    try {
      const TUSHARE_API_KEY = TUSHARE_CONFIG.API_TOKEN;
      const TUSHARE_API_URL = TUSHARE_CONFIG.API_URL;
  
      const data = await fetchFundManagerData(
        args.name,
        args.ann_date,
        TUSHARE_API_KEY,
        TUSHARE_API_URL
      );
  
      const formattedOutput = formatFundManagerData(data, args.name);
      
      return {
        content: [{ type: "text", text: formattedOutput }]
      };
  
    } catch (error) {
      return {
        content: [{ type: "text", text: `查询基金经理信息时发生错误: ${error instanceof Error ? error.message : String(error)}` }]
      };
    }
  } 

• src/tools/fundManagerByName.ts:3-20 (schema)

  The tool definition object containing the name, description, and input schema for validation.

  export const fundManagerByName = {
    name: "fund_manager_by_name",
    description: "根据基金经理姓名查询基金经理详细信息，包括管理的基金列表、个人背景、任职经历等",
    inputSchema: {
      type: "object" as const,
      properties: {
        name: {
          type: "string",
          description: "基金经理姓名，如'张凯'、'刘彦春'等"
        },
        ann_date: {
          type: "string",
          description: "公告日期，格式为YYYYMMDD，如'20230101'。用于限制查询的公告日期"
        }
      },
      required: ["name"]
    }
  };

• src/index.ts:168-172 (registration)

  Registration of the tool in the ListTools response handler, exposing it to MCP clients.

  {
    name: fundManagerByName.name,
    description: fundManagerByName.description,
    inputSchema: fundManagerByName.inputSchema
  },

• src/index.ts:288-292 (registration)

  Dispatch case in the CallToolRequest handler that routes calls to the runFundManagerByName function.

  case "fund_manager_by_name": {
    const name = String(request.params.arguments?.name);
    const ann_date = request.params.arguments?.ann_date ? String(request.params.arguments.ann_date) : undefined;
    return await runFundManagerByName({ name, ann_date });
  }

• src/httpServer.ts:70-70 (registration)

  Tool registration in the HTTP server's tool list for the /mcp tools/list endpoint.

  { name: fundManagerByName.name, description: fundManagerByName.description, inputSchema: (fundManagerByName as any).inputSchema },