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：从PyPI安装（推荐）
直接从PyPI安装软件包：
pip install fatebook-mcp或使用紫外线：
uv add fatebook-mcp选项2：从源代码安装
对于开发或最新功能：
- 克隆存储库：
git clone https://github.com/an1lam/fatebook-mcp.git
cd fatebook-mcp- 使用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:
- 找到你的uvx路径:
which uvx- 使用完整路径 在您的配置中：
"command": "/Users/yourusername/.local/bin/uvx"- 常见的紫外线照射位置:
- 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
例子
克劳德桌面
创建和跟踪预测： example interaction
回顾你的预测： example review interaction
克劳德代码
API文档
有关Fatebook API的更多详细信息，请参阅：
贡献
欢迎投稿！请随时提交问题或拉取请求。
支持
对于以下问题：
- 此MCP服务器：在GitHub上打开一个问题
- Fatebook API：联系Fatebook支持
- MCP/Claude桌面：参见 MCP文件