Ibex35 MCP Server

🚀 IBEX 35 MCP 服务器

IBEX 35 MCP 服务器基于 模型上下文协议（MCP），让 Claude 等大语言模型能够全面获取西班牙 IBEX 35 股票市场数据、公司治理信息和财务分析数据。

🚀 快速开始

前提条件

• Node.js 18 及以上版本
• Claude 桌面应用程序（或任何兼容 MCP 的客户端）

安装

选项 1：使用 NPM 全局安装（推荐）

npm install -g ibex35-mcp-server

选项 2：从源代码安装

git clone https://github.com/anbrme/ibex35-mcp-server.git
cd ibex35-mcp-server
npm install
npm run build

配置

环境变量

• IBEX35_API_URL：Cloudflare Worker API 的 URL（默认为 https://ibex35-api.ncdata.eu）
• IBEX35_API_KEY：可选的 API 密钥，用于身份验证（如果你的 Worker 需要）

Cloudflare Worker 配置

该服务器连接到现有的 Cloudflare Worker，该 Worker 提供对 D1 数据库的 API 访问，无需进行本地数据库设置。

使用方法

独立模式

npm start

Claude 桌面应用程序配置

将以下内容添加到 claude_desktop_config.json 文件中：

如果使用 NPM 安装：

{
  "mcpServers": {
    "ibex35-database": {
      "command": "ibex35-mcp",
      "env": {
        "IBEX35_API_URL": "https://ibex35-api.ncdata.eu"
      }
    }
  }
}

如果从源代码安装：

{
  "mcpServers": {
    "ibex35-database": {
      "command": "node",
      "args": ["/path/to/ibex35-mcp-server/dist/index.js"],
      "env": {
        "IBEX35_API_URL": "https://ibex35-api.ncdata.eu"
      }
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

开始使用

1. 完全重启 Claude 桌面应用程序。
2. 开始新的对话。
3. 询问有关 IBEX 35 数据的问题！

✨ 主要特性

核心数据访问

• 公司信息：提供所有 IBEX 35 公司的实时价格和关键指标。
• 历史数据：提供 OHLCV 数据、业绩跟踪和趋势分析。
• 股东信息：提供股权结构、集中度分析和交叉持股信息。
• 董事会成员：提供公司治理、董事会互锁和高管关系信息。
• 新闻与情绪分析：提供近期新闻，并进行情绪分析和相关性评分。
• ESG 数据：提供环境、社会和治理评分及指标。

高级分析 ⚡ 增强功能

• 自然语言处理：支持用普通英语提出复杂问题。
• 公司比较：可对财务、治理和业绩指标进行全面的公司对比分析。
• 趋势分析与预测：提供高级价格趋势分析和简单的预测功能。
• 投资风险评估：综合评估市场、治理和运营等多方面的投资风险。
• 分析师报告生成：生成专业的公司深度分析、行业概述和治理分析报告。
• 投资机会筛选：根据自定义标准对公司进行筛选和排名。
• 网络分析：分析董事会互锁关系和股东重叠情况。
• 治理风险评估：识别治理风险的警示信号和集中度指标。
• 市场相关性分析：分析行业表现和相关性。
• 游说情报：跟踪欧盟透明度数据和政治影响力。

特殊功能

• 实时同步：从 Google Sheets 和多个数据源同步数据。
• 周报生成：自动生成市场分析和治理亮点报告。
• 自定义查询：可在数据库上执行安全的 SQL 查询。
• 全面索引：针对复杂的关系查询进行了优化。

💻 使用示例

可用工具

公司数据

• get_all_companies - 列出所有 IBEX 35 公司的当前数据。
• get_company_by_symbol - 根据股票代码获取详细的公司信息。
• get_companies_by_sector - 按行业筛选公司。
• get_companies_with_pe_ratio - 按市盈率范围筛选公司。

治理与领导

• get_company_directors - 获取公司的董事会成员信息。
• get_board_interlocks - 查找在多个董事会任职的董事。
• get_directors_by_name - 在所有公司中搜索特定姓名的董事。

股权分析

• get_company_shareholders - 获取公司的股东结构信息。
• get_shareholder_overlap - 查找在多家公司持有股份的股东。
• get_top_shareholders_by_sector - 按行业查找顶级股东。

市场数据

• get_historical_prices - 获取历史 OHLCV 数据。
• get_top_performers - 查找特定时间段内表现最佳或最差的公司。

新闻与情绪分析

• get_recent_news - 获取最新的新闻文章，并附带情绪分析。
• get_news_by_sentiment - 按情绪（积极/消极/中性）筛选新闻。

游说与透明度

• get_lobbying_meetings - 获取欧盟的游说会议和活动信息。
• get_most_active_lobbyists - 查找游说活动最活跃的组织。

高级分析

• get_network_analysis - 对治理关系进行全面的网络分析。
• get_sector_correlation_analysis - 分析行业表现的相关性。

⚡ 增强功能 人工智能分析

• analyze_natural_query - 通过智能路由处理复杂的自然语言查询。
• compare_companies - 对公司进行多维度（财务、治理、业绩）比较。
• analyze_trends - 进行高级趋势分析和预测（公司、行业、市场、相关性）。
• assess_investment_risk - 全面评估投资风险（市场、治理、行业、流动性、集中度）。
• generate_analyst_report - 生成专业的分析师报告（公司深度分析、行业概述、治理分析）。
• screen_opportunities - 根据自定义标准和评分筛选投资机会。

报告

• get_weekly_reports - 获取生成的每周市场和治理报告。
• get_esg_scores - 获取 ESG 评分和可持续发展指标。

自定义访问

• execute_custom_query - 执行自定义 SQL 查询（仅支持 SELECT 语句）。

示例查询

公司治理

"Show me all directors who serve on multiple IBEX 35 boards"
"Which directors have political backgrounds or government connections?"
"Find potential conflicts of interest in IBEX 35 corporate governance"
"Who are the most connected directors in the Spanish corporate network?"

财务分析

"What are the largest IBEX 35 companies by market capitalization?"
"Show me companies with P/E ratios below 15"
"Which energy sector companies are in IBEX 35?"
"Compare the performance of banking vs telecommunications stocks"

股东情报

"Find institutional investors with holdings in multiple IBEX 35 companies"
"Show me the ownership structure of Banco Santander"
"Which companies have the most concentrated ownership?"
"Identify shareholder overlaps in the energy sector"

市场表现

"What are the best performing IBEX 35 stocks this month?"
"Show me companies that have dropped more than 10% recently"
"Compare sector performance across IBEX 35"
"Find undervalued companies based on P/E ratios"

研究与分析

"Analyze the political connections within IBEX 35 boards"
"Show me recent news sentiment for renewable energy companies"
"Which companies have the most diverse boards?"
"Find companies with suspicious governance patterns"

⚡ 增强功能 自然语言分析

"Which banking stocks have grown most in the last month?"
"Show me companies with high governance risk and explain why"
"Compare Santander vs BBVA across all metrics"
"Find undervalued large-cap companies with good governance scores"
"Generate a comprehensive report on the energy sector outlook"
"What are the price trends for telecommunications stocks?"
"Assess the investment risks of the banking sector"
"Screen for opportunities: P/E under 15, market cap over 10B, exclude energy"

📚 详细文档

安全机制

• 只读访问：数据库连接为只读模式。
• 查询限制：自定义查询仅允许使用 SELECT 语句。
• 输入验证：所有参数都经过验证和清理。
• 禁止危险操作：禁止执行 DROP、DELETE、UPDATE 等危险操作。

数据库架构

该服务器使用的综合数据库架构包括：

• companies：核心公司数据和指标。
• company_directors：董事会和高管信息。
• company_shareholders：股权结构信息。
• historical_prices：每日 OHLCV 市场数据。
• company_news：带有情绪分析的新闻文章。
• lobbying_meetings：欧盟透明度和游说数据。
• company_esg：ESG 评分和可持续发展指标。
• weekly_reports：生成的分析报告。

开发

# 开发模式，支持自动重新加载
npm run dev

# 编译 TypeScript
npm run build

# 启动生产服务器
npm start

贡献代码

此 MCP 服务器旨在与 IBEX 35 仪表盘生态系统配合使用。请确保任何更改都能与现有数据库架构和同步流程保持兼容。

📊 数据来源

该 MCP 服务器从以下权威西班牙数据源聚合数据：

• 马德里证券交易所（BME） - 实时市场数据和交易信息。
• CNMV - 官方监管文件和股东披露信息。
• 欧盟透明度登记册 - 企业游说活动和会议信息。
• 公司网站 - 董事会组成和治理结构信息。
• 金融新闻来源 - 市场情绪和公司特定新闻。

🔒 隐私与安全

• 无需 API 密钥：使用公开可用的数据源。
• 不涉及个人数据：仅使用公开披露的企业信息。
• 无跟踪机制：直接进行 API 访问，不收集数据。
• 开源透明：数据处理和分析过程完全透明。
• 只读访问：无法修改或删除任何数据。

📈 使用场景

金融专业人士

• 尽职调查和投资研究。
• 通过治理分析进行风险评估。
• 识别市场趋势和行业分析。
• 竞争情报和基准测试。

学术研究人员

• 公司治理研究和分析。
• 西班牙政治经济学研究。
• 企业关系网络分析。
• 金融市场行为研究。

合规与风险管理人员

• 验证董事会独立性。
• 识别政治关联。
• 分析股权集中度。
• 检测治理风险警示信号。

记者与分析师

• 对企业关联进行调查性研究。
• 绘制政治影响力地图。
• 市场分析和报告。
• 评估企业透明度。

🛠 故障排除

Claude 无法识别服务器

1. 检查配置文件位置和 JSON 语法。
2. 完全重启 Claude 桌面应用程序（⌘+Q，等待片刻后重新打开）。
3. 验证 Node.js 版本（需为 18 及以上）和安装情况。

安装问题

# 检查 Node.js 版本
node --version

# 如有需要，清除 NPM 缓存
npm cache clean --force

# 重新安装
npm install -g ibex35-mcp-server

API 连接问题

该服务器使用公共 API，无需身份验证。如果遇到错误，请执行以下命令测试 API 可达性：

curl https://ibex35-api.ncdata.eu/api/companies

📄 许可证

本项目采用 MIT 许可证，可用于商业和非商业用途。

🔗 相关资源

• IBEX 35 仪表盘 - 交互式 Web 界面。
• 模型上下文协议 - 官方 MCP 文档。
• Claude 桌面应用程序 - 下载 Claude 桌面应用程序。
• PulseMCP - 发现更多 MCP 服务器。

为 Claude 和 MCP 社区精心打造 ❤️

为全球的 AI 助手提供西班牙企业情报支持