AI Prediction MCP Server

MCPServer_aipresearch_us

人工智能预测MCP服务器

模型上下文协议（MCP）服务器，为Claude提供从aiprediction.us API访问AI预测数据的权限。

人工智能预测MCP服务器

模型上下文协议（MCP）服务器，为Claude提供从aiprediction.us API访问AI预测数据的权限。该服务器处理身份验证、日期格式化和数据检索，使Claude能够无缝访问交易预测和分析。

🚀 特性

• 自动身份验证：使用AI Prediction API处理基于令牌的身份验证
• 日期管理：将日期转换为YYMMDD格式，并自动获取当前日期
• 实时数据：检索任何日期的最后一个元素数据
• 错误处理：全面的日志记录和错误恢复
• 许可证管理：过期时自动刷新令牌

📋 先决条件

• Python 3.8或更高版本
• aiprediction.us上的活跃帐户
• Claude Desktop（或其他兼容MCP的客户端）

🛠️ 安装

1.克隆或下载文件

将这些文件下载到您的项目目录：

• MCPServer.py （主MCP服务器）
• requirements.txt （Python依赖关系）
• .env.example （环境配置模板）

2.设置Python环境

选项A：使用venv（推荐）

# Create virtual environment
python -m venv aiprediction-mcp
cd aiprediction-mcp

# Activate virtual environment
# On Windows:
Scripts\activate
# On macOS/Linux:
source bin/activate

# Install dependencies
pip install -r requirements.txt

选项B：使用conda

# Create conda environment
conda create -n aiprediction-mcp python=3.9
conda activate aiprediction-mcp

# Install dependencies
pip install -r requirements.txt

选项C：全局安装

# Install directly (not recommended for production)
pip install mcp aiohttp python-dotenv

3.配置环境变量

1. 复制示例文件：

   cp .env.example .env

1. 编辑 .env 使用您的凭据：

   # AI Prediction API Configuration
   API_BASE_URL=https://aiprediction.us
   API_USERNAME=your_username_here
   API_PASSWORD=your_password_here

替换 your_username_here 和 your_password_here 使用您的aiprediction.us真实凭据。

🎯 运行MCP服务器

测试服务器

python aiprediction-mcp-server.py

您应该看到如下输出：

📁 .env file loaded successfully
🚀 Starting AI Prediction MCP Server
🌐 API Base URL: https://aiprediction.us
🔐 Attempting authentication...
✅ Authentication successful!
✅ Token received: 190a0687f8db55f3640c...
📊 Testing data retrieval...
✅ Successfully retrieved data for 250613
🎯 MCP Server ready for connections

如果您看到错误：

• 缺少凭据：检查您的 .env 文件
• 认证失败：验证您的用户名/密码
• API错误：检查您的网络连接

保持服务器运行

使用Claude时，MCP服务器需要保持运行。你可以：

• 在终端中运行它并保持其打开状态
• 使用screen/tmux进行持久会话
• 作为后台服务运行

🔧 配置Claude桌面

1.查找Claude的配置文件

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json

窗户：

%APPDATA%/Claude/claude_desktop_config.json

2.添加MCP服务器配置

编辑配置文件并添加MCP服务器：

{
  "mcpServers": {
    "aiprediction": {
      "command": "python",
      "args": ["/full/path/to/your/MCPerver.py"],
      "env": {
        "API_BASE_URL": "https://aiprediction.us",
        "API_USERNAME": "your_username",
        "API_PASSWORD": "your_password"
      }
    }
  }
}

重要提示： 替换 /full/path/to/your/aiprediction-mcp-server.py 带有脚本的实际完整路径。

3.重新启动克劳德桌面

关闭并重新打开Claude Desktop以加载新配置。

💬 使用Claude与人工智能预测数据

配置后，您可以要求Claude访问您的AI预测数据：

查询示例

获取今天的数据：

Get today's AI prediction data

获取具体日期：

Get the prediction data for December 15, 2024

What's the data for 250612?

日期转换：

Convert March 15, 2025 to YYMMDD format

历史分析：

Compare prediction data between 241201 and 241215

可用工具

Claude将可以使用这些工具：

1. get_current_date_data -获取今天的预测数据
2. get_last_elements_by_date -获取任何特定日期的数据
3. format_date_yymmdd -将日期转换为YYMMDD格式
4. get_api_debug_info -获取API状态和调试信息

数据结构

API返回具有以下结构的数据：

{
  "DID": "250613",
  "ID": 421,
  "ctime": ["09:30 AM", "09:31 AM", ...],
  "lookup_method": "did",
  "last_elements": {
    "sp": 5970.62,
    "es": 5972.75,
    "p1": 5970.0,
    "c1": 5975.0,
    // ... more prediction fields
  }
}

🔍 故障排除

常见问题

1.“缺少凭据”错误

• 检查你的 .env 文件存在并且格式正确
• 确保周围没有多余的空间 = 标志
• 验证文件是否与脚本位于同一目录中

2.“身份验证失败”错误

• 验证您的用户名和密码是否正确
• 检查您的aiprediction.us帐户是否处于活动状态
• 请先尝试通过网站登录

3.在Claude中“找不到MCP服务器”

• 检查中的完整路径 claude_desktop_config.json
• 确保Python在您的系统PATH中
• 尝试使用Python可执行文件的绝对路径

4.特定日期“未找到数据”

• 某些日期可能没有预测数据
• 尝试最近的交易日（工作日）
• 检查日期格式是否正确（YYMMDD）

调试模式

要查看详细的日志记录，您可以修改服务器以显示更多信息：

# Run with Python's verbose output
python -v aiprediction-mcp-server.py

检查配置

验证Claude是否可以看到您的MCP服务器：

1. 打开克劳德桌面
2. 在界面中查找MCP服务器指示灯
3. 试着问：“你可以使用哪些MCP工具？”

📚 api参考

环境变量

日期格式

API使用 年月日 格式：

• 250613 =2025年6月13日
• 241225 =2024年12月25日
• 240101 =2024年1月1日

可用端点

MCP服务器访问以下API端点：

• POST /api-token-auth/ -身份验证
• GET /api/v53a/{did}/last-elements/ -获取预测数据
• GET /api/debug/v53a/general/ -调试信息

🤝 贡献

要改进此MCP服务器：

1. 分叉存储库
2. 进行更改
3. 使用您的AI预测帐户进行测试
4. 提交拉取请求

📄 许可证

该项目根据MIT许可证获得许可。

🆘 支持

对于问题：

1. 检查上面的故障排除部分
2. 通过他们的网站验证你的aiprediction.us帐户是否正常工作
3. 测试MCP服务器输出是否有详细的错误消息
4. 检查Claude Desktop的MCP配置

______________________________________________________________________

用AI预测快乐交易！ 📈#aiprediction_us_MCP_服务器