CSMAR MCP Server

Сервер протокола контекста модели (MCP) для финансовой базы данных Guotai'an (CSMAR), поддерживающий прямой доступ к финансовым данным CSMAR в Claude Code.

✨ Функциональные возможности

• Полный доступ к данным CSMAR: поддержка более 240 баз данных, включая финансовую отчетность, биржевые торги, информацию о компаниях и т.д.

• Интеллектуальное управление входом: поддержка автоматического входа через переменные окружения и кэширование токенов

• 11 инструментов MCP: полный набор функций, охватывающий исследование баз данных, запросы данных, предварительный просмотр и т.д.

• Промежуточный слой Python: стабильная оболочка на основе CSMAR-PYTHON SDK

• Простая настройка: конфигурация в один клик, поддержка нативной интеграции с Claude Code

📋 Предварительные требования

1. Учетная запись CSMAR: действующая институциональная учетная запись CSMAR (Guotai'an)

2. Python 3.8+: требуется установка CSMAR-PYTHON SDK

3. Node.js 18+: для запуска сервера MCP

4. Claude Code: последняя версия редактора Claude Code

🚀 Быстрый старт

1. Клонирование проекта

git clone https://github.com/yourusername/csmar-mcp-server.git
cd csmar-mcp-server

2. Установка зависимостей

npm install

3. Настройка переменных окружения

Скопируйте шаблон файла конфигурации:

cp config/.env.example .env

Отредактируйте файл .env, введя данные своей учетной записи CSMAR:

CSMAR_API_BASE=https://api.gtarsc.com
CSMAR_API_KEY=你的API密钥（如有）
CSMAR_USERNAME=你的CSMAR用户名
CSMAR_PASSWORD=你的CSMAR密码
CSMAR_LANG=0  # 0=中文, 1=英文

4. Настройка Claude Code

Добавьте конфигурацию сервера MCP в файл конфигурации Claude Code:

Windows (%APPDATA%/Claude/claude_desktop_config.json): 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"
      }
    }
  }
}

5. Перезапуск Claude Code

Перезапустите Claude Code, чтобы загрузить сервер MCP.

🔧 Использование

Проверка установки

Запустите в Claude Code:

mcp__csmar__csmar_list_databases()

Если вы видите список баз данных, значит, установка прошла успешно!

Базовое исследование данных

# 列出所有可用数据库（约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"
)

🛠️ Доступные инструменты

📁 Структура проекта

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 гг.

• Данные, связанные с ИИ: 2024-2025 гг.

• Биржевая торговля: обновление в реальном времени

⚠️ Меры предосторожности

Ограничения запросов

• Максимум 200 000 записей за раз: для больших наборов данных требуется постраничный запрос

• Ограничение частоты (rate limit) 30 минут для одинаковых условий: избегайте частых запросов с одинаковыми условиями

• Формат времени: необходимо использовать формат "YYYY-MM-DD"

Пример постраничного запроса

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

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

🐛 Устранение неполадок

Часто задаваемые вопросы

1. "Сервер MCP не отвечает"

• Убедитесь, что Claude Code был перезапущен

• Проверьте путь к файлу .mcp.json

• Протестируйте клиент Python вручную:

  echo '{"action":"list_databases","params":{}}' | python src/python_client.py

2. "База данных не существует"

• Используйте csmar_list_databases() для получения точного названия

• Проверьте, содержит ли название базы данных пробелы

• Убедитесь, что у учетной записи есть права доступа к этой базе данных

3. Результат запроса пуст

• Проверьте правильность временного диапазона

• Проверьте синтаксис условий запроса

• Используйте preview() для предварительного просмотра формата данных

4. Ошибка импорта CSMAR SDK

• Убедитесь, что CSMAR-PYTHON SDK установлен правильно

• Проверьте конфигурацию пути Python

• Проверьте настройки пути в src/python_client.py

Файлы журналов

• Журнал CSMAR: csmar-log.log

• Журнал клиента Python: вывод через stderr

• Журнал сервера MCP: вывод через stderr

🤝 Вклад в проект

Приветствуются 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 (Guotai'an): предоставление услуг финансовых данных

• Anthropic: разработка протокола Model Context Protocol

• Claude Code: отличная среда для программирования с ИИ

📞 Поддержка

• Официальная поддержка CSMAR: service@gtadata.com, 400-888-3636

• Issues проекта: GitHub Issues

• Документация: подробные руководства в каталоге docs/

💡 Совет: перед началом использования убедитесь, что учетная запись CSMAR и переменные окружения настроены правильно!