Stock MCP Server

Instructions

Implementation Reference

• src/watch.ts:26-52 (handler)

  The core implementation of addWatch function that adds a stock to the watch list. It loads existing data, checks for duplicates, creates a new WatchItem with timestamp, saves to watch.json file, and returns the new item.

  export function addWatch(
    code: string,
    name: string,
    reason: string,
    market: Market
  ): WatchItem {
    const watchList = loadWatchList();
  
    // 检查是否已存在
    const exists = watchList.some(item => item.code === code && item.market === market);
    if (exists) {
      throw new Error('Stock already in watch list');
    }
  
    const newItem: WatchItem = {
      code,
      name,
      reason,
      market,
      createdAt: new Date().toISOString(),
    };
  
    watchList.push(newItem);
    saveWatchList(watchList);
  
    return newItem;
  }

• src/index.ts:392-408 (handler)

  The MCP tool handler for watch_add that parses input arguments using AddWatchSchema, calls watch.addWatch() function with the parameters, and returns the result as formatted JSON.

  if (name === 'watch_add') {
    const params = AddWatchSchema.parse(args);
    const result = watch.addWatch(
      params.code,
      params.name,
      params.reason,
      params.market as Market
    );
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/index.ts:204-217 (registration)

  Tool registration for watch_add defining its name, description, input schema properties (code, name, reason, market), and required fields.

  {
    name: 'watch_add',
    description: '添加观察股票',
    inputSchema: {
      type: 'object',
      properties: {
        code: { type: 'string', description: '股票代码' },
        name: { type: 'string', description: '股票名称' },
        reason: { type: 'string', description: '观察理由或目标' },
        market: { type: 'string', enum: ['sh', 'sz', 'hk', 'us'], description: '市场' },
      },
      required: ['code', 'name', 'reason', 'market'],
    },
  },

• src/index.ts:53-58 (schema)

  Zod schema definition (AddWatchSchema) for input validation with required fields: code (string), name (string), reason (string), and market (enum: sh, sz, hk, us).

  const AddWatchSchema = z.object({
    code: z.string().describe('股票代码'),
    name: z.string().describe('股票名称'),
    reason: z.string().describe('观察理由或目标'),
    market: z.enum(['sh', 'sz', 'hk', 'us']).describe('市场'),
  });

• src/types.ts:93-99 (schema)

  Type definition for WatchItem interface defining the structure of watch list items with code, name, reason, market, and createdAt fields.

  export interface WatchItem {
    code: string;
    name: string;
    reason: string;
    market: Market;
    createdAt: string;
  }