AI导哈

预测跟踪服务器

Fatebook MCP服务器是一个与Fatebook预测跟踪平台集成的模型上下文协议服务器，允许AI助手创建、管理和跟踪预测。

  • by an1lam
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 an1lam/fatebook-mcp

使用说明

Fatebook MCP服务器

一种模型上下文协议（MCP）服务器，提供与 脂肪书，一个预测跟踪平台。该服务器允许像Claude这样的人工智能助手直接通过MCP创建、管理和跟踪预测。

特性

  • 创建问题：用预测进行预测（0-100%概率）
  • 列出问题：使用筛选选项查看您的预测
  • 获取问题详细信息：检索有关具体问题的全面信息
  • 添加预测：更新你对现有问题的预测概率
  • 添加注释：添加评论以跟踪您的推理
  • 解决问题：将问题标记为已解决（是/否/模糊）
  • 编辑问题：更新问题标题、解决日期和注释
  • 删除问题：删除不再需要的问题
  • 计数预测：跟踪您的预测活动

测试和兼容性

此MCP服务器已在Mac OS X 14.5上进行了测试：

  • 克劳德代码（CLI）
  • 克劳德桌面
  • MCP检查员

据我所知，它没有违反任何MCP协议要求，但鉴于MCP是一个不断发展的协议，某些功能或MCP客户端可能无法得到完全支持。如果您遇到其他MCP实现的问题，请将其报告为GitHub问题。

安装

先决条件

  • Python 3.13或更高版本
  • 紫外线 （推荐）或pip
  • Fatebook帐户和API密钥

获取Fatebook API密钥

  1. 登录到…… 脂肪书
  2. 引导到 API设置
  3. 生成并复制API密钥

选项1：从PyPI安装（推荐）

直接从PyPI安装软件包：

pip install fatebook-mcp

或使用紫外线：

uv add fatebook-mcp

选项2：从源代码安装

对于开发或最新功能：

  1. 克隆存储库：
git clone https://github.com/an1lam/fatebook-mcp.git
cd fatebook-mcp
  1. 使用uv安装依赖项：
uv sync

快速开始

直接用uvx运行

安装后测试服务器的最简单方法是使用uvx：

# Run directly from PyPI (no installation needed)
uvx fatebook-mcp

# Or run from local directory during development
uvx --from . fatebook-mcp

服务器将启动并等待MCP客户端通过stdio连接。使用Ctrl+C停止它。

使用Claude Desktop和 克劳德代码

克劳德桌面

将以下配置之一添加到您的Claude Desktop配置文件中：

macOS

地点： ~/Library/Application Support/Claude/claude_desktop_config.json

视窗

地点： %APPDATA%\Claude\claude_desktop_config.json

选项1：使用PyPI包（推荐）

{
  "mcpServers": {
    "fatebook": {
      "command": "uvx",
      "args": ["fatebook-mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

备注：如果克劳德桌面找不到 uvx，请改用完整路径：

{
  "mcpServers": {
    "fatebook": {
      "command": "/Users/yourusername/.local/bin/uvx",
      "args": ["fatebook-mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

使用以下工具查找您的uvx路径： which uvx

选项2：开发/源代码安装

{
  "mcpServers": {
    "fatebook": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/fatebook-mcp",
        "run",
        "python",
        "-m",
        "fatebook_mcp"
      ],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

替换 /path/to/fatebook-mcp 带有克隆此存储库的实际路径。

克劳德代码（CLI）

对于Claude Code，您可以通过多种方式添加此服务器：

选项1：使用PyPI包（推荐）

# Add the Fatebook MCP server using uvx
claude mcp add fatebook --env FATEBOOK_API_KEY=your-api-key-here -- uvx fatebook-mcp

# Verify it was added successfully
claude mcp list

选项2：从Claude Desktop导入

如果您已经在Claude Desktop中配置了此设置，则可以导入这些设置：

claude mcp add-from-claude-desktop

选项3：项目特定配置

创建一个 .mcp.json 项目中的文件：

使用PyPI包：

{
  "mcpServers": {
    "fatebook": {
      "command": "uvx",
      "args": ["fatebook-mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

如果 uvx 未找到，请使用完整路径（使用查找 which uvx):

{
  "mcpServers": {
    "fatebook": {
      "command": "/Users/yourusername/.local/bin/uvx",
      "args": ["fatebook-mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

使用开发/源代码安装：

{
  "mcpServers": {
    "fatebook": {
      "command": "uv",
      "args": ["--directory", "/path/to/fatebook-mcp", "run", "python", "-m", "fatebook_mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

替换 /path/to/fatebook-mcp 带有克隆此存储库的实际路径。

开发与测试

附加设置

除了仅使用MCP服务器所需的上述设置之外，单独运行MCP服务器并运行其测试需要获取API密钥并将其导出到您的环境中。

您可以通过直接导出来完成此操作：

export FATEBOOK_API_KEY="your-api-key-here"

或者创建一个 .env 文件：

FATEBOOK_API_KEY=your-api-key-here

运行集成测试

运行集成测试以验证您的设置：

uv run pytest test_client.py

这将测试所有可用的端点，并确认服务器是否正常工作。

备注：只有当您为测试用户拥有正确的API密钥时，这些测试才会成功。如果你的开发需要运行这些测试，现在给我（作者）发电子邮件。

在本地运行服务器

使用uvx（推荐）：

uvx --from . fatebook-mcp

使用uv运行模块：

uv run python -m fatebook_mcp

服务器将启动并等待MCP客户端连接。

测试和兼容性

此MCP服务器已通过以下测试：

  • 克劳德代码（CLI）
  • 克劳德桌面
  • MCP检查员

由于MCP是一个不断发展的协议，某些功能或MCP客户端可能无法得到完全支持。如果您遇到其他MCP实现的问题，请将其报告为GitHub问题。

故障排除

未找到uvx命令

如果Claude Desktop显示“找不到命令”错误 uvx:

  1. 找到你的uvx路径:

    which uvx

  2. 使用完整路径 在您的配置中：

    "command": "/Users/yourusername/.local/bin/uvx"

  3. 常见的紫外线照射位置:

    • macOS： /Users/yourusername/.local/bin/uvx
    • Linux： /home/yourusername/.local/bin/uvx

API关键问题

  • 确保您的API密钥有效且处于活动状态
  • 检查API密钥是否在环境或配置中正确设置
  • 尝试直接在请求中提供API密钥

连接问题

  • 验证Claude Desktop配置中的服务器路径是否正确
  • 检查Python 3.13+是否已安装且可访问
  • 确保uv依赖项已正确安装 uv sync

问题格式

  • 日期应采用YYYY-MM-DD格式
  • 预测值必须介于0.0和1.0之间
  • 创建问题时提供问题ID

例子

克劳德桌面

创建和跟踪预测：

回顾你的预测：

克劳德代码

API文档

有关Fatebook API的更多详细信息，请参阅：

贡献

欢迎投稿！请随时提交问题或拉取请求。

支持

对于以下问题：

  • 此MCP服务器：在GitHub上打开一个问题
  • Fatebook API：联系Fatebook支持
  • MCP/Claude桌面：参见 MCP文件

相关 MCP