AI导哈

加密货币数据分析服务

altFINS MCP服务器提供加密货币日历事件、新闻、市场筛选数据、技术分析和历史价格数据等功能，适用于加密货币交易者和分析师。

  • by danywayGit
  • 本地部署
  • 更新于
在 GitHub 查看 danywayGit/altfinsMCP

使用说明

altFINS MCP服务器-功能和设置

此存储库包含altFINS服务器的即用型本地MCP配置，以及每种功能的示例。

这个MCP服务器给你什么

altFINS MCP服务器提供以下工具：

  • 加密日历事件（即将到来的代币、交易所和生态系统事件）
  • 加密货币新闻（来源和最新消息）
  • 市场筛选器数据（快照指标、筛选器和可用数据类型）
  • 技术分析数据（指标驱动视图）
  • 历史分析（时间序列指标历史）
  • OHLC价格历史和最新蜡烛

它还可以根据您的服务器版本公开其他工具（例如与投资组合相关的工具）。保持最新状态的最可靠方法是使用以下命令查询实时MCP服务器 list_tools.

实时工具发现（Python直接MCP）

要自动更新您的功能列表，请在此仓库中使用Python直接集成：

  • examples/python/altfins_direct_tool_call.py
  • examples/python/README.md

此脚本：

  1. 直接连接到 https://mcp.altfins.com/mcp 和 X-Api-Key.
  2. 呼叫 list_tools 并将当前工具导出到 feature-runs/00-live-tool-catalog.md.
  3. 运行直接呼叫，包括：
    • technicalAnalysis_getTechnicalAnalysisData — 分页的，自动获取所有页面（约50个精选条目）
    • ohlc_getLatestData
  4. 将原始直接呼叫输出保存到 feature-runs/00-live-direct-tool-call-output.json.

用于技术分析的可选符号过滤器：

$env:ALTFINS_TA_SYMBOLS="BTC,ETH,SOL"

为此脚本安装Python依赖项：

pip install -r requirements.txt

选项A（当前终端中的外壳变量）：

$env:ALTFINS_API_KEY="YOUR_ALTFINS_API_KEY"
.venv/Scripts/python.exe examples/python/altfins_direct_tool_call.py

选项B（推荐，本地 .env 文件）：

Copy-Item .env.example .env

然后设置 ALTFINS_API_KEY 在 .env.

实时发现的工具清单生成于：

  • feature-runs/00-live-tool-catalog.md

使用生成的文件作为事实来源，而不是此README中的硬编码列表。

API直接实施（无MCP）

此回购还包括用于技术分析的直接REST API实现：

  • examples/python/altfins_direct_api_technical_analysis.py

使用的端点：

  • https://altfins.com/api/v2/public/technical-analysis/data

用同样的方式跑步 ALTFINS_API_KEY 其他示例使用的设置：

.venv/Scripts/python.exe examples/python/altfins_direct_api_technical_analysis.py

可选单符号过滤器：

$env:ALTFINS_TA_SYMBOLS="ADA"
.venv/Scripts/python.exe examples/python/altfins_direct_api_technical_analysis.py

生成的输出：

  • feature-runs/00-live-direct-api-technical-analysis.json

注意：如果直接API返回HTTP 403，则您的密钥可能对MCP的使用有效，但未被授权用于此REST端点。

符号列表

获取2000多个支持符号的完整列表：

.venv/Scripts/python.exe examples/python/altfins_symbols_list.py

生成的输出：

  • feature-runs/00-live-symbols-list.json

工具能力图（各一个示例）

下面是每个功能/工具的一个实际示例。

1） 分析类型发现

  • 工具： mcp_altfins-mcp-s_analytics_getAnalyticsTypes
  • 它的作用：列出您可以历史查询的所有有效分析类型标识符。
  • 请求示例：
Show all analytics types available from altFINS so I can pick one for historical analysis.

2） 所有符号的最新分析历史记录

  • 工具： mcp_altfins-mcp-s_analytics_getAllLatestHistoryData
  • 它的作用：在许多符号中获取所选分析指标的最新可用数据点。
  • 请求示例：
Get the latest RSI14 history datapoint across all tracked symbols.

3） 一个符号的历史分析

  • 工具： mcp_altfins-mcp-s_analytics_getHistoryData
  • 它的作用：返回一种分析类型和符号的时间序列值。
  • 请求示例：
Get SMA50 historical values for BTCUSDT over the last 90 days.

4） OHLC历史

  • 工具： mcp_altfins-mcp-s_ohlc_getHistoryData
  • 它的作用：返回符号和时间范围的历史OHLC蜡烛。
  • 请求示例：
Get daily OHLC history for ETHUSDT for the last 6 months.

5） 最新OHLC蜡烛

  • 工具： mcp_altfins-mcp-s_ohlc_getLatestData
  • 它的作用：返回一个符号/时间段的最新OHLC蜡烛。
  • 请求示例：
Get the latest 1h OHLC candle for SOLUSDT.

6） 加密日历事件

  • 工具： mcp_altfins-mcp-s_getCryptoCalendarEvents
  • 它的作用：获取预定的加密事件。
  • 请求示例：
Show crypto calendar events coming in the next 7 days.

7） 新闻来源

  • 工具： mcp_altfins-mcp-s_news_getCryptoNewsSources
  • 它的作用：列出支持的新闻来源。
  • 请求示例：
List all available crypto news sources in altFINS.

8） 新闻信息

  • 工具： mcp_altfins-mcp-s_news_getCryptoNewsMessages
  • 它的作用：返回最近的加密货币新闻消息。
  • 请求示例：
Get the latest 20 crypto news messages from all sources.

9） 筛选器数据类型

  • 工具： mcp_altfins-mcp-s_screener_getAltfinsScreenerDataTypes
  • 它的作用：列出您可以查询的可用筛选器字段/列。
  • 请求示例：
Show all altFINS screener data types and their meanings.

10） 筛选器数据

  • 工具： mcp_altfins-mcp-s_screener_getAltfinsScreenerData
  • 它的作用：返回所选筛选器/列的筛选器结果。
  • 请求示例：
Get screener data for top coins with bullish trend and volume above average.

11） 技术分析数据

  • 工具： mcp_altfins-mcp-s_technicalAnalysis_getTechnicalAnalysisData
  • 它的作用：返回精心策划的交易设置和专业分析师的观点。
  • 请求示例：
Get technical analysis data for ADAUSDT on the 4h timeframe.

12） 用户组合

  • 工具： getUserPortfolio
  • 它的作用：返回经过身份验证的用户的连接投资组合。
  • 请求示例：
Get my connected user portfolio from altFINS.

每个功能运行文件

每个功能执行（提示+输出）都保存在一个文件中：

通过直接MCP发现/调用实时生成的文件：

保存在此存储库中的本地MCP配置

此仓库在以下位置存储了一个可用的altFINS MCP配置模板：

  • keep/altfins-mcp.json

将其复制到您的VS Code用户MCP配置中（例如 %APPDATA%\Code\User\mcp.json)并根据需要进行调整。

快速设置

  1. 创建虚拟环境（推荐）：
python -m venv .venv
.\.venv\Scripts\Activate.ps1
  1. 安装依赖项：
pip install -r requirements.txt
  1. 从模板创建环境文件：
Copy-Item .env.example .env
  1. 在中设置API密钥 .env:
ALTFINS_API_KEY=your_real_api_key_here
  1. 运行实时发现：
.venv/Scripts/python.exe examples/python/altfins_direct_tool_call.py

  1. 在VS Code中打开此文件夹，并确保启用了MCP支持。

  2. 重新加载窗口(Developer: Reload Window)如果MCP服务器没有立即被拿起。

  3. 在Copilot Chat（代理模式）中，尝试此README中的示例提示之一。

备注

  • 如果您的altFINS MCP服务器配置格式更改，请更新 keep/altfins-mcp.json 以及相应的VS代码用户MCP配置。
  • 保守秘密 .env （或您的操作系统秘密存储），不在已提交的文件中。

相关 MCP