星战科技xingzhan.cloud
返回市场
命运书-mcp

命运书-mcp

作者：an1lam2 星标更新：2025-08-28
安装使用来源：spider==github.com

项目介绍

Fatebook MCP Server

PyPI 版本 Python 3.13+ CI

一个模型上下文协议（MCP）服务器，提供与预测跟踪平台Fatebook的集成。此服务器允许像Claude这样的AI助手通过MCP创建、管理和跟踪预测。

<a href="https://glama.ai/mcp/servers/@an1lam/fatebook-mcp"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=4045302888,1136652585&fm=3081&app=31&f=PNG?w=760&h=400" alt="Fatebook Server MCP 服务器" /> </a>

功能

  • 创建问题：带有预测（0-100% 概率）的问题
  • 列出问题：查看您的预测并使用过滤选项
  • 获取问题详情：检索特定问题的全面信息
  • 添加预测：更新现有问题的预测概率
  • 添加评论：添加评论以跟踪您的推理过程
  • 解决疑问：标记问题为已解决（是/否/模棱两可）
  • 编辑问题：更新问题标题、解决日期和备注
  • 删除问题：移除不再需要的问题
  • 统计预测：跟踪您的预测活动

测试与兼容性

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

  • Claude Code (CLI)
  • Claude Desktop
  • MCP Inspector

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

安装

先决条件

  • Python 3.13 或更高版本
  • uv（推荐）或 pip
  • Fatebook 账户和 API 密钥

获取您的 Fatebook API 密钥

  1. 登录到 Fatebook
  2. 导航至 API 设置
  3. 生成并复制您的 API 密钥

方案 1：从 PyPI 安装（推荐）

直接从 PyPI 安装包：

pip install fatebook-mcp

或者使用 uv：

uv add fatebook-mcp

方案 2：从源码安装

用于开发或最新功能：

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

快速开始

直接使用 uvx 运行

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

# 直接从 PyPI 运行（无需安装）
uvx fatebook-mcp

# 或者在开发期间从本地目录运行
uvx --from . fatebook-mcp

服务器将启动并等待通过标准输入输出连接的MCP客户端。使用Ctrl+C停止它。

使用 Claude Desktop 和 Claude Code

Claude Desktop

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

macOS

位置：~/Library/Application Support/Claude/claude_desktop_config.json

Windows

位置：%APPDATA%\Claude\claude_desktop_config.json

方案 1：使用 PyPI 包（推荐）

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

注意：如果 Claude Desktop 找不到 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 替换为您克隆此仓库的实际路径。

Claude Code (CLI)

对于 Claude Code，您可以按以下几种方式添加此服务器：

方案 1：使用 PyPI 包（推荐）

# 使用 uvx 添加 Fatebook MCP 服务器
claude mcp add fatebook --env FATEBOOK_API_KEY=your-api-key-here -- uvx fatebook-mcp

# 验证是否成功添加
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 run 与模块：

uv run python -m fatebook_mcp

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

测试与兼容性

此 MCP 服务器已与以下内容进行过测试：

  • Claude Code (CLI)
  • Claude Desktop
  • MCP Inspector

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

故障排除

uvx 命令未找到

如果 Claude Desktop 显示“命令未找到”错误：

  1. 找到您的 uvx 路径：

    which uvx

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

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

  3. 常见的 uvx 位置：

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

API 密钥问题

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

连接问题

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

问题格式

  • 日期应为 YYYY-MM-DD 格式
  • 预测值必须在 0.0 到 1.0 之间
  • 创建问题时会提供问题 ID

示例

Claude Desktop

创建并跟踪预测： 示例交互

查看您的预测： 示例审查交互

Claude Code

示例列表交互

API 文档

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

贡献

欢迎贡献！请随时提交问题或拉取请求。

支持

对于以下问题：

  • 此 MCP 服务器：在 GitHub 上打开问题
  • Fatebook API：联系 Fatebook 支持
  • MCP/Claude Desktop：参见 MCP 文档