eastmoney-skills2mcp: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

东方财富妙想 MCP Server — 封装东方财富公开 API 与妙想（dfcfs）授权 API 为 11 个 MCP Tool，供 Claude Code 等 AI 客户端调用。

Tech Stack

• Runtime: Node.js 18+ (ESM, "type": "module")
• Language: TypeScript 5.x (strict mode, Node16 module resolution)
• MCP SDK: @modelcontextprotocol/sdk v1.x — Streamable HTTP transport
• Framework: Express 5
• Validation: Zod (via zod/v4)

Commands

npm run build    # tsc → dist/
npm start        # node dist/index.js
npm run dev      # tsc --watch（开发模式）

Architecture

src/
├── index.ts           # Express + MCP StreamableHTTP 入口，Bearer auth 中间件，会话管理
├── api/
│   ├── eastmoney.ts   # 东方财富 / 妙想 API 封装（公开域名 + 妙想授权接口，codeToFc 等辅助函数）
│   └── eventStore.ts  # InMemoryEventStore — SSE 重放支持
└── tools/
    ├── diagnose.ts        # 综合诊股 — 并行调 4 个子 API（评分/五维图/估值/概况）
    ├── financial.ts       # 财务数据 — main/income/cashflow 三种报表
    ├── screening.ts       # 智能选股 — 构建 filter，POST 选股器
    ├── hotspot.ts         # 热点发现 — push2 板块排行
    ├── earnings.ts        # 业绩点评 — 盈利预测 + 机构评级
    ├── news_search.ts     # 金融资讯搜索 — 妙想 news-search
    ├── mx_data.ts         # 妙想金融数据查询 — 妙想 query
    ├── mx_xuangu.ts       # 妙想智能选股 — 妙想 stock-screen
    ├── mx_zixuan.ts       # 自选股 — 妙想 self-select get/manage
    └── lof_arbitrage.ts   # LOF 套利日报 — 新浪行情 + 天天基金净值

每个 tool 文件导出 register(server: McpServer)，在 index.ts 中统一注册。Tool handler 返回 { content: [{ type: "text", text }] } 或 { content: [...], isError: true }。

Environment Variables

Variable	Default	Description
PORT	9000	Server port
AUTH_TOKEN	(empty)	Bearer token for auth; empty = no auth
MX_APIKEY	(empty)	妙想 API Key，妙想系列工具（news_search / mx_data / mx_xuangu / mx_zixuan）必需
ALLOWED_HOSTS	localhost,127.0.0.1,::1	允许访问的 Host（逗号分隔），公网/域名部署时按需添加

EastMoney / 妙想 API Domains