Stock MCP Server

Instructions

Implementation Reference

• src/index.ts:433-447 (handler)

  Tool handler that processes watch_remove requests - validates input using RemoveWatchSchema, calls watch.removeWatch(), and returns success/failure response

  if (name === 'watch_remove') {
    const params = RemoveWatchSchema.parse(args);
    const success = watch.removeWatch(params.code, params.market as Market);
    if (!success) {
      throw new Error('Watch item not found');
    }
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({ success: true }, null, 2),
        },
      ],
    };
  }

• src/watch.ts:77-88 (handler)

  Core implementation of removeWatch function - loads watch list, finds item by code and market, removes it, saves updated list, and returns success status

  export function removeWatch(code: string, market: Market): boolean {
    const watchList = loadWatchList();
    const index = watchList.findIndex(item => item.code === code && item.market === market);
  
    if (index === -1) {
      return false;
    }
  
    watchList.splice(index, 1);
    saveWatchList(watchList);
    return true;
  }

• src/index.ts:67-70 (schema)

  Zod validation schema for watch_remove tool parameters - requires code (string) and market (enum: sh, sz, hk, us)

  const RemoveWatchSchema = z.object({
    code: z.string().describe('股票代码'),
    market: z.enum(['sh', 'sz', 'hk', 'us']).describe('市场'),
  });

• src/index.ts:232-243 (registration)

  Tool registration in MCP server - defines watch_remove tool with name, description, and JSON input schema for the tools list endpoint

  {
    name: 'watch_remove',
    description: '删除观察股票',
    inputSchema: {
      type: 'object',
      properties: {
        code: { type: 'string', description: '股票代码' },
        market: { type: 'string', enum: ['sh', 'sz', 'hk', 'us'], description: '市场' },
      },
      required: ['code', 'market'],
    },
  },