Tushare Monorepo (pnpm + Turborepo)

一个现代化、严格类型的 Tushare Pro 多包仓库，提供从请求引擎到强类型 SDK、再到 MCP 服务器与示例前端的全链路支持。

Monorepo 结构

• packages/core: @tushare/core — 请求引擎、错误模型、固定窗口限流、指数退避重试、内存缓存
• packages/tushare-sdk: @tushare/sdk — 强类型门面聚合 SDK（零 any）
• packages/mcp: @tushare/mcp — MCP 服务器：向 AI 暴露 100+ 金融数据接口（sdk_call/sdk_schema/sdk_search）
• packages/tushare-docgen: tushare-docgen — 从官方文档抓取/生成 nav.json 与 apis.json 以及类型（内部工具）
• packages/web-demo: web-demo — Vite + React 示例前端，直接消费 @tushare/sdk 与文档生成物

更多关于 MCP 的背景与规划见 packages/mcp/README.md 与 docs/mcp.md。

快速开始

1. 安装依赖（Node.js 18+）

pnpm i

2. 构建所有包

pnpm -w build

3. 在本地开发任一包（示例：MCP）

pnpm -C packages/mcp dev

常用脚本（Workspace 根）

• 构建全部包：pnpm -w build
• 类型检查：pnpm -w typecheck
• 清理产物：pnpm -w clean

各包也提供独立脚本，见对应包内的 package.json 与 README。

环境变量速览

• Tushare Token：TUSHARE_TOKEN（亦兼容 TUSHARE_API_TOKEN、TS_TOKEN）
• MCP 配置（见 packages/mcp/src/env.ts 与 README）：
  • TUSHARE_MCP_POPULAR_TOOLS（默认 20，0 关闭 Top-N 独立工具）
  • TUSHARE_MCP_MAX_CONCURRENCY（默认 1）
  • TUSHARE_MCP_TIMEOUT_MS（默认 30000）
  • TUSHARE_MCP_RETRY（默认 3）
  • TUSHARE_MCP_BACKOFF_MS（默认 200）
  • TUSHARE_MCP_VERBOSE（默认 false）
  • TUSHARE_MCP_STDIO（默认 true）

安全提示：请勿在浏览器端直接暴露真实生产 Token，可通过后端代理或使用受限 Token。

许可证

本项目采用 MIT 协议，详见 LICENSE。