项目简介: Aiera MCP 服务器是一个实验性的后端应用，它实现了 Model Context Protocol (MCP)，允许大型语言模型 (LLM) 客户端通过标准化的方式访问 Aiera 的综合金融数据。它将 Aiera REST API 接口封装为一系列可供 LLM 调用的工具 (Tools)，并提供相关的资源信息，从而使 LLM 能够理解和利用 Aiera 的金融市场洞察力、公司信息、事件、文档和 SEC 备案等数据。
主要功能点:
- 金融数据访问: 通过丰富的 MCP 工具，LLM 可以查询 Aiera 提供的各种金融数据，包括：
  - 事件数据: 获取公司的财报会议、演示文稿、股东会议等事件信息及会议纪要。
  - 公司信息: 检索股票代码、ISIN、RIC 等公司标识，获取公司摘要、行业分类和索引成分。
  - 法规文件: 查找并获取 SEC 备案文件（如 10-K, 10-Q, 8-K 等）。
  - 公司文档: 访问公司发布的各类文档，如新闻稿、幻灯片演示文稿等。
  - 第三方洞察: 查询 Third Bridge 专家洞察事件。
- 工具调用: 将复杂的 Aiera API 调用抽象为 LLM 友好的工具接口，LLM 可以根据用户请求选择并调用相应的工具。
- 上下文提供: 通过 MCP 协议，向 LLM 提供结构化的金融数据上下文和工具使用说明，增强 LLM 理解和生成相关金融洞察的能力。
- 多种传输协议: 支持 Stdio、SSE (Server-Sent Events) 和 Streamable HTTP 等多种传输协议进行通信。

安装步骤:

确保 Python 环境: 您的系统需要安装 Python 3.11 或更高版本。
安装 'uv' 包管理器: 推荐使用 Astral UV 作为包管理器。如果尚未安装，请参考 Astral UV 官方文档进行安装，并确保您的 'uv' 版本支持 'uvx' 命令。

克隆仓库并安装依赖:

git clone https://github.com/aiera-inc/aiera-mcp.git
cd aiera-mcp
pip install -r requirements.txt

设置 Aiera API 密钥: 您需要一个 Aiera API 密钥。将其设置为环境变量：

export AIERA_API_KEY="your-aiera-api-key"

启动服务器:
```
uv run entrypoint.py
```
服务器将在后台运行，等待 MCP 客户端连接。

服务器配置 (用于 MCP 客户端): 此 MCP 服务器旨在通过 MCP 客户端（如 Claude Desktop）进行连接和使用。以下是将其集成到 MCP 客户端配置中的示例 JSON 片段，您需要根据实际环境进行调整：

{
    "mcpServers": {
        "Aiera MCP": {
           "command": "/path/to/your/uv", // 替换为 uv 可执行文件的完整路径，例如：/home/username/.local/bin/uv
           "args": [
               "run",
               "--with",
               "mcp[cli]",
               "mcp",
               "run",
               "/path/to/your/aiera-mcp/aiera_mcp/server.py" // 替换为 aiera-mcp 仓库中 server.py 文件的完整路径
            ],
            "env": {
               "AIERA_API_KEY": "your-aiera-api-key" // 替换为您的 Aiera API 密钥
            }
        }
    }
}

command: 'uv' 可执行文件的路径。您可以通过在终端运行 'which uv' 来查找其路径。
args: 启动 MCP 服务器的参数。这会指示 'uv' 运行 'aiera_mcp/server.py' 文件。
env: 环境变量，用于传递您的 Aiera API 密钥。

基本使用方法: 一旦 MCP 服务器配置并启动成功，并通过 MCP 客户端连接，您就可以通过自然语言向 LLM 提出金融数据相关的请求。例如：
- “获取 Apple Inc. 最新的财报电话会议纪要，并总结关键点。”
- “查找过去三个月所有关于 Microsoft Corporation 的 SEC 10-Q 备案文件。”
- “提供能源行业的股票概览。” LLM 将利用 Aiera MCP 服务器提供的工具，执行相应的 API 调用，并返回相关数据以回答您的问题。

关键词

信息