🤖 AIGroup Market MCP Server

基于 Tushare 和百度新闻的金融数据 MCP（Model Context Protocol）服务器，面向股票、基金、宏观经济、财经资讯等多类查询场景。

📌 项目概览

aigroup-market-mcp 提供统一的金融数据 MCP 接口，适合在 Claude Desktop、RooCode、各类 MCP 客户端或自建 AI 工作流中使用。

核心能力包括：

• 股票、指数、基金、宏观经济等结构化金融数据查询
• 财经新闻与 7×24 热点资讯检索
• A 股 / 港股 / 美股等多市场支持
• 技术指标计算与格式化输出
• stdio 与 HTTP 两种接入方式

✨ 核心特性

数据能力

• Tushare API：股票、基金、宏观经济、财务等权威数据
• 百度新闻抓取：补充财经新闻资讯与热点信息
• 多市场覆盖：A 股、美股、港股、外汇、期货、加密货币等

工具能力

• 行情数据：日 K、分钟 K、指数与技术指标
• 财务数据：利润表、资产负债表、现金流、财务指标
• 基金与债券：基金净值、基金经理、可转债等
• 市场交易数据：大宗交易、资金流向、融资融券、龙虎榜
• 新闻与宏观数据：财经新闻、7×24 热点、宏观经济指标

技术实现

• MCP SDK 1.27.1：使用现代 McpServer API
• Zod 参数校验：提高类型安全与输入可靠性
• Streamable HTTP 传输：更适合远程部署与服务化接入
• 通知防抖优化：降低批量场景下的网络噪音

🚀 快速开始

环境要求

• Node.js >= 18
• npm >= 8
• 可用的 TUSHARE_TOKEN

方式一：直接运行（推荐）

export TUSHARE_TOKEN=your_tushare_token_here
npx -y aigroup-market-mcp

如需 HTTP 模式：

export TUSHARE_TOKEN=your_tushare_token_here
npx -y aigroup-market-mcp-http

方式二：本地源码运行

git clone https://github.com/jackdark425/aigroup-market-mcp.git
cd aigroup-market-mcp
npm install
npm run build
export TUSHARE_TOKEN=your_tushare_token_here
npm run start:stdio

HTTP 模式：

npm run start:http

⚙️ 环境变量

TUSHARE_TOKEN=your_tushare_token_here
TUSHARE_API_URL=https://api.tushare.pro
PORT=3000
NODE_ENV=development

获取 Tushare Token：https://tushare.pro

🔌 MCP 客户端配置

使用 npx

{
  "mcpServers": {
    "aigroup-market-mcp": {
      "command": "npx",
      "args": ["-y", "aigroup-market-mcp"],
      "env": {
        "TUSHARE_TOKEN": "your_tushare_token_here"
      }
    }
  }
}

使用本地构建结果

{
  "mcpServers": {
    "aigroup-market-mcp": {
      "command": "node",
      "args": ["build/index.js"],
      "cwd": "/path/to/aigroup-market-mcp",
      "env": {
        "TUSHARE_TOKEN": "your_tushare_token_here"
      }
    }
  }
}

🛠️ 主要工具

| 工具名称 | 功能描述 | 数据来源 | |---------|---------|---------| | current_timestamp | 获取当前东八区时间戳 | 系统生成 | | finance_news | 财经媒体新闻搜索 | 百度新闻爬虫 | | stock_data | 股票历史行情数据 | Tushare | | stock_data_minutes | 分钟 K 线数据 | Tushare | | index_data | 股票指数数据 | Tushare | | macro_econ | 宏观经济数据 | Tushare | | company_performance | A 股公司综合表现数据 | Tushare | | fund_data | 公募基金数据 | Tushare | | fund_manager_by_name | 基金经理信息查询 | Tushare | | convertible_bond | 可转债数据 | Tushare | | block_trade | 大宗交易数据 | Tushare | | money_flow | 资金流向数据 | Tushare | | margin_trade | 融资融券数据 | Tushare | | company_performance_us | 美股公司业绩数据 | Tushare | | csi_index_constituents | 中证指数成分股数据 | Tushare | | dragon_tiger_inst | 龙虎榜机构成交明细 | Tushare | | hot_news_7x24 | 7×24 热点新闻 | Tushare |

📚 文档

• Tushare API 接口对照文档
• 发布指南

🏗️ 项目结构

aigroup-market-mcp/
├── src/
│   ├── index.ts
│   ├── httpServer.ts
│   ├── config.ts
│   ├── core/
│   ├── tools/
│   └── utils/
├── docs/
├── exports/
├── csv_exports/
└── README.md

🔧 开发

npm install
npm run build
npm run dev

常用脚本：

• npm run start:stdio
• npm run start:http
• npm run dev
• npm run watch

🤝 贡献

欢迎通过 Issue 或 Pull Request 提交改进建议。

基本流程：

1. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 推送分支
5. 发起 Pull Request

📄 许可证与使用说明

本项目采用 MIT License。

这意味着你可以在遵守 MIT 许可证文本的前提下，自由地：

• 使用本项目进行个人或商业用途
• 复制、修改、合并和分发代码
• 将本项目作为更大系统的一部分进行二次开发
• 在保留原始版权与许可证声明的情况下发布衍生版本

请注意：

• 你必须保留 原仓库中的版权声明与 MIT 许可证文本
• 本项目按“原样”提供（AS IS），作者不对适销性、特定用途适用性或非侵权提供担保
• 第三方数据源条款不等于 MIT：使用 Tushare、新闻源等服务时，仍需自行遵守其服务条款、调用限制与数据合规要求

完整授权文本见 LICENSE。

🙏 致谢

参考项目

• guangxiangdebizi/FinanceMCP
  • 仓库地址: https://github.com/guangxiangdebizi/FinanceMCP
  • 参考范围: 整体产品方向、金融数据 MCP 组织方式、部分能力设计

数据与生态支持

• Tushare：优秀的金融数据服务平台
• 百度新闻：丰富的财经资讯来源
• MCP 社区：为跨平台工具集成提供协议与生态支持

📞 支持

• Issues: https://github.com/jackdark425/aigroup-market-mcp/issues
• Repository: https://github.com/jackdark425/aigroup-market-mcp
• Email: [email protected]