Profitelligence MCP Server

🚀 Profitelligence MCP Server

为AI智能体提供金融情报。 通过单个MCP服务器，让Claude能够访问内幕交易数据、美国证券交易委员会（SEC）文件、经济指标和多信号分析。

免费开始使用 · 查看定价

🚀 快速开始

选项A：通过MCP目录连接（推荐）

这是最简单的开始方式：

1. 访问 Anthropic MCP目录
2. 找到并点击 Profitelligence
3. 使用你的Google账户完成OAuth身份验证
4. 开始提出金融问题！

无需API密钥，身份验证会自动处理。

选项B：使用API密钥手动设置

1. 创建免费账户

在 profitelligence.com 上注册，无需信用卡。

免费套餐包括：

• 访问交易量前500的股票
• 内幕交易数据（Form 4）
• SEC 8-K文件摘要
• 经济指标（FRED）
• 每天250次API调用

2. 获取API密钥

从你的 账户仪表盘 生成API密钥。

3. 添加到Claude

Claude代码（单行命令）：

claude mcp add profitelligence --transport http \
  https://mcp.profitelligence.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Claude桌面版（添加到 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "profitelligence": {
      "url": "https://mcp.profitelligence.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

完成以上步骤后，你就可以问Claude：“本周科技股有哪些内幕买入情况？”

✨ 主要特性

为何选择Profitelligence？

传统的金融API会返回大量原始数据。你的AI智能体需要消耗大量令牌来解析CSV文件、进行多次调用并拼凑上下文。Profitelligence则不同。

我们提供 语义丰富、针对大语言模型（LLM）优化的响应，专为AI智能体设计：

你将获得的功能

• 内幕交易情报 — 可通过实体搜索的Form 4文件（例如 “查找沃伦·巴菲特的交易”）
• SEC文件分析 — 由AI总结的8 - K事件，并带有影响评分
• 市场数据 — 公司简介、开盘价、最高价、最低价、收盘价（OHLC）、行业/板块背景
• 经济指标 — 来自美联储（FRED）的宏观经济数据
• 多信号分析 — 结合内幕活动、SEC事件和价格走势的机会评分（专业版）

设计安全可靠

此MCP服务器是Profitelligence REST API之上的 轻量级、无状态层：

• ✅ 只读 — 无法修改你的账户或执行交易
• ✅ 无数据存储 — 响应直接传输，不会在本地缓存
• ✅ 开源 — 你可以自行审查代码，约2000行Python代码
• ✅ 你的API密钥 — 你控制访问权限，可随时从仪表盘撤销

📦 安装指南

自托管（可选）

大多数用户无需此步骤。 mcp.profitelligence.com 上的托管版本免费、快速且无需任何设置。只需添加你的API密钥即可使用（见上文 快速开始）。

此仓库的存在是为了让你能够：

• 审查代码 — 确切了解使用MCP服务器时运行的内容
• 出于隐私考虑自托管 — 如果你愿意，可以运行自己的实例
• 自定义 — 分叉仓库并添加自己的工具

何时选择自托管

Docker Hub

我们将多架构镜像（amd64 + arm64）发布到Docker Hub：

docker pull profitelligence/mcp-server:latest

在标准输入输出模式下运行（适用于Claude桌面版）：

docker run -i --rm \
  -e PROF_API_KEY=pk_live_xxx \
  profitelligence/mcp-server:latest

在HTTP模式下运行（用于开发/测试）：

docker run -d -p 3000:3000 \
  -e PROF_API_KEY=pk_live_xxx \
  -e PROF_MCP_MODE=http \
  profitelligence/mcp-server:latest

从源代码安装

git clone https://github.com/profitelligence/profitelligence-mcp-server.git
cd profitelligence-mcp-server
pip install -e .
PROF_API_KEY=pk_live_xxx python -m src.server

环境变量

网络搜索隐私

托管版本使用我们的共享基础设施。自托管时，你可以提供自己的 Brave搜索API密钥（每月2000次免费查询）：

• ✅ 你的搜索查询直接发送到Brave
• ✅ 我们永远不会看到你搜索的内容
• ✅ 如果未提供密钥，将回退到DuckDuckGo

开发设置请参阅 CONTRIBUTING.md。

💻 使用示例

示例1：获取市场概览

用户提示： "目前市场情况如何？"

执行过程：

• 服务器调用 pulse() 工具
• 返回当前市场的活跃股票（涨幅最大、跌幅最大、成交量最大）
• 显示最近有重大影响的SEC 8 - K文件，并带有AI生成的摘要
• 列出Form 4文件中的重要内幕交易
• 提供FRED的关键经济指标

示例2：研究一家公司

用户提示： "告诉我英伟达的内幕交易活动和近期文件情况。"

执行过程：

• 服务器调用 investigate("NVDA") 工具
• 返回公司简介，包括行业、市值和首席执行官信息
• 显示价格历史和技术信号
• 列出最近的8 - K重大事件及影响评分
• 提供Form 4内幕交易摘要和情绪分析
• 包括10 - K/10 - Q文件中的最新财务信息

示例3：寻找投资机会

用户提示： "寻找有内幕买入的科技股。"

执行过程：

• 服务器调用 screen(focus="insider", sector="Technology") 工具
• 扫描科技行业的内幕买入集群
• 返回排名机会列表及交易详情
• 显示内幕人员姓名、职位和交易价值
• 提供基于多信号分析的机会评分

示例4：跟踪机构投资者

用户提示： "伯克希尔·哈撒韦在买入什么股票？"

执行过程：

• 服务器调用 institutional("manager", identifier="Berkshire") 工具
• 使用模糊搜索找到匹配的机构经理
• 返回最新13F文件中的主要持仓
• 显示最近的持仓变化（新买入、增持、减持）
• 列出高置信度持仓（占投资组合5%以上）

📚 详细文档

可用工具

7个工具旨在最大程度提高令牌效率。每个工具都能以丰富的上下文响应完整的问题：

工具参考

了解 何时 使用每个工具是获得最佳结果的关键。以下是使用思路：

pulse() — 了解当前市场情况

使用场景： 用户想在不指定特定公司的情况下了解市场概况。

返回内容： 市场活跃股票、近期有重大影响的8 - K文件、重要内幕交易、关键经济指标。

无参数，直接调用即可。

pulse()

适用场景： 开始会话、了解市场方向、“我今天应该关注什么？”

investigate(subject) — 深入研究特定实体

使用场景： 用户指定要研究的特定公司、内幕人员或行业。

自动检测实体类型：

• 股票代码 (AAPL, NVDA) → 公司研究
• CIK编号 (0001067983) → 内幕人员研究
• 行业名称 (Technology) → 行业分析

公司研究返回内容：

• 简介、价格历史、重大事件（8 - K文件）
• 内幕情报（Form 4摘要 + 近期交易）
• 财务信息（损益表、资产负债表、10 - K/10 - Q现金流量表）
• 机会信号、技术指标

investigate("AAPL")                           # 公司
investigate("0001067983")                     # 通过CIK编号查询沃伦·巴菲特
investigate("Technology", entity_type="sector")  # 行业

适用场景： "告诉我关于X的信息"、"X的情况如何？"、决策前的研究。

screen(focus) — 在市场中寻找机会

使用场景： 用户想发现符合特定标准的股票，而不是研究特定的一只股票。

参数：

• focus：筛选信号
  • "all" — 所有信号（默认）
  • "multi_signal" — 具有多个确认信号的股票
  • "insider" — 内幕买入集群
  • "events" — 有重大影响的8 - K文件
• sector：按行业筛选（例如 "Technology"）
• min_score：最低机会评分（0 - 100）
• days：回溯期（默认7天）
• limit：最大结果数（默认25）

screen()                                    # 所有信号
screen(focus="insider", sector="Technology") # 科技行业内幕买入
screen(focus="events", days=14)             # 近期重大事件

适用场景： "有哪些投资机会？"、"寻找有内幕买入的股票。"

assess(symbol) — 评估你持有的持仓健康状况

使用场景： 用户持有某只股票，想评估是继续持有、增持还是卖出。

返回内容：

• 当前价格走势和技术信号
• 近期重大事件（8 - K文件）
• 内幕情绪（内幕人员是买入还是卖出？）
• 机构情绪（13F文件中的积累/减持情况）
• 财务快照
• 风险因素

assess("NVDA")
assess("AAPL", days=90)  # 更长的回溯期

适用场景： 投资组合审查、"我持有的X股票情况如何？"、"我应该担心X股票吗？"

institutional(query_type) — 13F机构投资者情报

使用场景： 用户想了解大型资金的动向。

查询类型：

• "manager" — 分析特定基金（按名称或CIK编号）
• "security" — 谁持有特定股票？
• "signal" — 寻找具有机构资金流向模式的股票

信号类型（当 query_type="signal" 时）：

• "accumulation" — 机构正在买入的股票
• "distribution" — 机构正在卖出的股票
• "conviction" — 高置信度持仓（占投资组合5%以上）
• "new" — 新的机构持仓

institutional("manager", identifier="Citadel")     # 城堡投资集团持有哪些股票？
institutional("security", identifier="NVDA")       # 谁持有英伟达股票？
institutional("signal", signal_type="accumulation") # 聪明资金正在买入的股票

适用场景： "伯克希尔在买入什么？"、"谁持有英伟达股票？"、"跟随聪明资金。"

search(q) — 在平台上查找任何信息

使用场景： 用户正在寻找特定信息，但不知道在哪里可以找到。

搜索范围：

• SEC 8 - K文件（带有LLM提取的见解）
• 公司（按名称或代码）
• 内幕人员（高管、董事）
• 机构经理（13F文件提交者）

参数：

• q：搜索查询（至少2个字符）
• entity_type：过滤结果 — "filing", "company", "insider", "manager"
• sector：按行业过滤
• impact：按影响级别过滤文件 — "HIGH", "MEDIUM", "LOW"
• limit：最大结果数（默认20，最大100）

search("CEO resignation")                           # 查找首席执行官离职文件
search("NVIDIA", entity_type="company")             # 查找英伟达公司
search("Buffett", entity_type="insider")            # 查找沃伦·巴菲特
search("activist", entity_type="manager")           # 查找激进基金
search("acquisition", sector="Technology", impact="HIGH")  # 高影响的科技行业并购

适用场景： "查找关于X的文件"、"搜索Y"、不确定从哪里开始查找时的探索。

service_info(info_type) — 账户和服务信息

使用场景： 用户询问其订阅套餐、功能或服务本身的信息。

信息类型：

• "overview" — 服务描述和功能（默认）
• "profile" — 用户的订阅套餐、功能、账户状态
• "pricing" — 订阅套餐和价格
• "capabilities" — 可用工具和数据源
• "status" — 服务器健康状况和配置

service_info()            # 概述
service_info("profile")   # 你的账户信息
service_info("pricing")   # 定价信息

适用场景： "你能做什么？"、"我的套餐是什么？"、"专业版费用是多少？"

工具选择指南

MCP提示

预构建的研究工作流程，可生成完整的报告：

• insider_activity_report — 某只股票的内幕交易分析
• sec_filing_intelligence_report — 8 - K文件分析
• macro_market_conditions_report — 宏观市场状况
• influential_investor_research — 有影响力的投资者深入研究
• sector_opportunity_scan — 多信号行业分析
• quarterly_stock_checkup — 投资组合持仓季度检查

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE。

🔗 其他信息

定价与套餐

早期采用者定价 — 前1000名用户可锁定专业版每月 $4.99 和精英版每月 $9.99 的价格（常规价格：每月 $10 和每月 $29）。随时升级。

隐私政策

请参阅我们的隐私政策：profitelligence.com/privacy

支持

• 问题反馈：GitHub Issues
• 联系我们：profitelligence.com/contact
• 电子邮件：support@profitelligence.com