CSMAR MCP Server

CSMAR MCP Server

Enables direct access to CSMAR financial databases through Claude Code. Supports 240+ databases including financial statements, stock trading data, and company information with intelligent login management and 11 MCP tools.

Category
访问服务器

README

CSMAR MCP 服务器

License MCP Protocol Node.js Python

国泰安（CSMAR）金融数据库的 Model Context Protocol (MCP) 服务器，支持在 Claude Code 中直接访问 CSMAR 金融数据。

✨ 功能特性

  • 完整的 CSMAR 数据访问：支持 240+ 个数据库，包括财务报表、股票交易、公司信息等
  • 智能登录管理：支持环境变量自动登录和令牌缓存
  • 11 个 MCP 工具：涵盖数据库探索、数据查询、预览等全功能
  • 持久化 Python 进程：复用 Python 会话，大幅提升性能
  • 请求重试机制：网络不稳定时自动重试
  • 优雅关闭：支持 SIGTERM/SIGINT 信号
  • 健康检查：随时查看服务状态
  • Python 中间层：基于 CSMAR-PYTHON SDK 的稳定封装
  • 配置简单：一键式配置，支持 Claude Code 原生集成

📋 前提条件

  1. CSMAR 账号：有效的 CSMAR（国泰安）机构账号（个人或机构账号均可）
  2. Python 3.8+：需要安装 CSMAR-PYTHON SDK 及其依赖
    • 安装 Python 依赖：pip install urllib3 websocket websocket_client pandas prettytable
    • 下载并安装 CSMAR-PYTHON SDK（从官网或联系 CSMAR 获取）
  3. Node.js 18+：运行 MCP 服务器
  4. Claude Code：最新版本的 Claude Code 编辑器

🚀 快速开始

1. 克隆项目

git clone https://github.com/ww11-max/Csmar-MCP-server.git
cd Csmar-MCP-server

2. 安装依赖

# 安装Node.js依赖
npm install

# 安装Python依赖（CSMAR SDK所需）
pip install urllib3 websocket websocket_client pandas prettytable

# 安装CSMAR-PYTHON SDK
# 从CSMAR官网下载SDK压缩包，解压到Python的site-packages目录
# 或者按照官方文档安装：https://www.gtadata.com/products/csmar-api

3. 配置环境变量

在项目根目录创建 .env 文件：

# CSMAR 配置
CSMAR_API_BASE=https://api.gtarsc.com
CSMAR_USERNAME=你的CSMAR用户名
CSMAR_PASSWORD=你的CSMAR密码
CSMAR_LANG=0  # 0=中文, 1=英文

⚠️ 安全提示：请勿将 .env 文件提交到 Git！已配置 .gitignore 自动忽略。

4. 配置 Claude Code(包含Claude客户端和vscode扩展两种配置方式)

在 Claude Code 的配置文件中添加 MCP 服务器配置：

Windows (%APPDATA%/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "csmar": {
      "command": "node",
      "args": ["C:\\path\\to\\Csmar-MCP-server\\src\\index.js"],
      "env": {
        "CSMAR_API_BASE": "https://api.gtarsc.com",
        "CSMAR_USERNAME": "你的CSMAR用户名",
        "CSMAR_PASSWORD": "你的CSMAR密码",
        "CSMAR_LANG": "0"
      }
    }
  }
}

macOS/Linux (~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "csmar": {
      "command": "node",
      "args": ["/path/to/Csmar-MCP-server/src/index.js"],
      "env": {
        "CSMAR_API_BASE": "https://api.gtarsc.com",
        "CSMAR_USERNAME": "你的CSMAR用户名",
        "CSMAR_PASSWORD": "你的CSMAR密码",
        "CSMAR_LANG": "0"
      }
    }
  }
}

如果用户使用的是VS code中的Claude code扩展，配置方式如下：

配置env文件之后，修改Claude Code MCP配置 VSCode 中 Claude Code 的 MCP 配置文件在：

%APPDATA%/Code/User/globalStorage/saoudval.claude-code/mcp.json

或者在 VSCode 设置中搜索 MCP，找到 MCP Servers 配置入口 添加配置：

{
  "mcpServers": {
    "csmar": {
      "command": "node",
      "args": ["C:\\path\\to\\Csmar-MCP-server\\src\\index.js"],
      "env": {
        "CSMAR_API_BASE": "https://api.gtarsc.com",
        "CSMAR_USERNAME": "你的CSMAR用户名",
        "CSMAR_PASSWORD": "你的CSMAR密码",
        "CSMAR_LANG": "0"
      }
    }
  }
}

⚠️ 路径需替换为你实际克隆的项目路径，例如 D:\Projects\Csmar-MCP-server\src\index.js

5. 重启 Claude Code

重启 Claude Code 以加载 MCP 服务器。

🔧 使用方法

验证安装

mcp__csmar__csmar_health_check()

基本数据探索

# 列出所有可用数据库（约240个）
mcp__csmar__csmar_list_databases()

# 查看"财务报表"数据库中的表
mcp__csmar__csmar_list_tables(database_name="财务报表")

# 查看"FS_Combas"表的字段
mcp__csmar__csmar_list_fields(table_name="FS_Combas")

# 预览表数据（前几行）
mcp__csmar__csmar_preview(table_name="FS_Combas")

数据查询示例

# 查询财务报表数据
mcp__csmar__csmar_query(
    table_name="FS_Combas",
    columns=["Stkcd", "ShortName", "Accper", "Typrep", "A001000000"],
    condition="Stkcd like '3%' and Typrep='A'",
    start_time="2020-01-01",
    end_time="2021-12-31",
    limit=5
)

# 查询记录数量
mcp__csmar__csmar_query_count(
    table_name="FS_Combas",
    condition="Stkcd like '3%'",
    start_time="2020-01-01",
    end_time="2021-12-31"
)

# 获取股票数据
mcp__csmar__get_stock_data(
    stock_code="000001",
    start_date="2024-01-01",
    end_date="2024-12-31",
    frequency="daily"
)

# 获取财务数据
mcp__csmar__get_financial_data(
    stock_code="000001",
    start_date="2020-01-01",
    end_date="2024-12-31",
    indicators=["A001000000", "A002000000"]
)

# 获取公司信息
mcp__csmar__get_company_info(stock_code="000001")

🛠️ 可用工具

工具名称 描述 参数
csmar_health_check 检查服务健康状态 无
csmar_login 登录 CSMAR 账户 account, pwd, lang
csmar_list_databases 列出可访问的数据库 无
csmar_list_tables 列出数据库中的表 database_name
csmar_list_fields 列出表中的字段 table_name
csmar_query 通用数据查询 table_name, columns, condition, start_time, end_time, limit, format
csmar_preview 预览表数据 table_name
csmar_query_count 查询记录数量 table_name, columns, condition, start_time, end_time
get_stock_data 获取股票交易数据 stock_code, start_date, end_date, frequency
get_financial_data 获取财务数据 stock_code, start_date, end_date, indicators
get_company_info 获取公司基本信息 stock_code

📁 项目结构

csmar-mcp-server/
├── src/
│   ├── index.js              # MCP 服务器主文件
│   └── python_client.py      # Python 客户端
├── config/
│   ├── .env.example          # 环境变量示例
│   └── .mcp.json             # MCP 配置示例
├── docs/
│   ├── CSMAR_MCP_配置完成报告.md
│   ├── 快速开始指南.md
│   └── CSMAR机构账号配置指南.md
├── examples/
│   └── test_input.json       # 测试输入示例
├── package.json              # Node.js 依赖
├── README.md                 # 本文件
└── .gitignore               # Git 忽略文件

🔍 数据库推荐

常用数据库

  • 财务报表：财务报表, FS_Combas, FS_Comins, FS_Comscfd
  • 股票交易：股票市场交易数据, 股票日行情
  • 公司信息：公司基本信息, 上市公司基本信息
  • 宏观经济：宏观经济数据库

数据时间范围

  • 财务报表：2018-2022 年
  • AI 相关数据：2024-2025 年
  • 股票交易：实时更新

⚠️ 注意事项

查询限制

  • 每次最多 20 万条记录：大数据集需要分页查询
  • 相同条件 30 分钟限流：避免频繁查询相同条件
  • 时间格式：必须使用 "YYYY-MM-DD" 格式

分页查询示例

# 第1页
condition = "Stkcd like '3%' limit 0,200000"
# 第2页
condition = "Stkcd like '3%' limit 200000,200000"

mcp__csmar__csmar_query(
    table_name="FS_Combas",
    columns=["Stkcd", "ShortName", "Accper", "Typrep"],
    condition=condition
)

🐛 故障排除

常见问题

1. "MCP 服务器未响应"

  • 确认 Claude Code 已重启
  • 检查配置文件路径是否正确
  • 手动测试 Python 客户端：
    echo '{"action":"check_availability","params":{}}' | python src/python_client.py --once

2. "数据库不存在"

  • 使用 csmar_list_databases() 获取准确名称
  • 检查数据库名称是否包含空格
  • 确认账号有该数据库访问权限

3. 查询结果为空

  • 检查时间范围是否正确
  • 验证查询条件语法
  • 使用 preview() 先查看数据格式

4. CSMAR SDK 导入失败

  • 确认 CSMAR-PYTHON SDK 已正确安装
  • 运行 python src/python_client.py 查看详细错误信息

日志文件

  • Python 客户端日志：通过 stderr 输出
  • MCP 服务器日志：通过 stderr 输出

🔄 更新日志

v1.1.0 (2026-04-15)

  • ✨ 新增持久化 Python 进程模式，大幅提升性能
  • ✨ 新增健康检查工具 csmar_health_check
  • ✨ 实现了 get_stock_data、get_financial_data、get_company_info 工具
  • 🔧 修复 Python 路径硬编码问题，自动检测 site-packages
  • 🔧 修复 zod 导入问题
  • 🔧 添加请求重试机制
  • 🔧 添加优雅关闭支持

v1.0.0

  • 🎉 初始版本

🤝 贡献

欢迎提交 Issue 和 Pull Request！

  1. Fork 项目
  2. 创建功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 创建 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

  • CSMAR（国泰安）：提供金融数据服务
  • Anthropic：开发 Model Context Protocol
  • Claude Code：优秀的 AI 编程环境

📞 支持

  • CSMAR 官方支持：service@gtadata.com，400-888-3636
  • 项目 Issues：GitHub Issues
  • 文档：查看 docs/ 目录下的详细指南

💡 提示：开始使用前，请确保已正确配置 CSMAR 账号和环境变量！

推荐服务器

Baidu Map

Baidu Map

百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

官方
精选
JavaScript
Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

通过模型上下文协议启用与 Audiense Insights 账户的交互，从而促进营销洞察和受众数据的提取和分析，包括人口统计信息、行为和影响者互动。

官方
精选
本地
TypeScript
VeyraX

VeyraX

一个单一的 MCP 工具，连接你所有喜爱的工具：Gmail、日历以及其他 40 多个工具。

官方
精选
本地
graphlit-mcp-server

graphlit-mcp-server

模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外，还可以将任何内容（从 Slack 到 Gmail 再到播客订阅源）导入到 Graphlit 项目中，然后从 MCP 客户端检索相关内容。

官方
精选
TypeScript
Kagi MCP Server

Kagi MCP Server

一个 MCP 服务器，集成了 Kagi 搜索功能和 Claude AI，使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。

官方
精选
Python
e2b-mcp-server

e2b-mcp-server

使用 MCP 通过 e2b 运行代码。

官方
精选
Neon MCP Server

Neon MCP Server

用于与 Neon 管理 API 和数据库交互的 MCP 服务器

官方
精选
Exa MCP Server

Exa MCP Server

模型上下文协议（MCP）服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。

官方
精选