Warpcast MCP 服务器

用于 Warpcast 集成的模型上下文协议（MCP）服务器，允许您使用 Claude 与您的 Warpcast 账户进行交互。 该实现现在遵循来自 MCP Python SDK 的 FastMCP 样式服务器。

功能

• 向您的 Warpcast 账户发布帖子
• 从 Warpcast 读取帖子
• 按关键词或标签搜索帖子
• 浏览并互动频道
• 关注/取消关注频道
• 获取热门帖子

Warpcast API https://docs.farcaster.xyz/reference/warpcast/api

使用方法

mcp-warpcast-server 通常会在配置 Warpcast 工具时由 Claude Desktop 的 MCP 客户端自动启动。 服务器启动后，您可以请求 Claude 执行以下操作：

• "发布关于 [主题] 的帖子"
• "阅读 [用户名] 的最新帖子"
• "搜索关于 [主题] 的帖子"
• "显示 Warpcast 上的热门帖子"
• "显示 Warpcast 上的热门频道"
• "获取 [频道] 频道的帖子"
• "为我关注 [频道] 频道"

提供的工具

此 MCP 服务器提供了多个 Claude 可以使用的工具：

1. post-cast: 在 Warpcast 上创建新帖子（最多 320 字符）
2. get-user-casts: 从特定用户处检索最近的帖子
3. search-casts: 按关键词或短语搜索帖子
4. get-trending-casts: 获取当前在 Warpcast 上热门的帖子
5. get-all-channels: 列出 Warpcast 上可用的所有频道
6. get-channel: 获取特定频道的信息
7. get-channel-casts: 获取特定频道的帖子
8. follow-channel: 关注一个频道
9. unfollow-channel: 取消关注一个频道

设置

当配置 Warpcast 工具时，Claude Desktop 通常会为您启动此服务器。如果您想手动运行服务器进行开发，则需要执行以下步骤：

1. 创建一个 Python 虚拟环境（建议使用 Python 3.11 或更高版本）：

   python3 -m venv venv
   source venv/bin/activate
   

2. 安装依赖项（需求包括 MCP Python SDK）：

   pip install -r requirements.txt
   

3. 提供 Warpcast API 令牌：

   • 登录到 Warpcast 并打开 设置 > 开发者。
   • 单击 创建 API 令牌 并复制值。
   • 将 WARPCAST_API_TOKEN 添加到您的 Claude 桌面配置的 env 部分中。
   • 如果手动启动服务器，可以在您的 shell 中导出令牌：

     export WARPCAST_API_TOKEN=YOUR_TOKEN
     

   服务器在启动时验证此变量。如果缺少，将记录警告，并授权请求将以 HTTP 500 错误响应。

4. （可选）手动启动服务器： main.py 导出的 app 变量是使用 mcp.streamable_http_app() 创建的，因此可以由任何 ASGI 服务器提供服务。

   uvicorn main:app --reload
   

服务器公开了与上述工具匹配的 HTTP 端点以及由 FastMCP 提供的标准 /mcp 端点。

与 Claude Desktop 一起使用

按照以下步骤从 Claude 桌面应用程序访问 Warpcast 工具：

1. 使用上面的设置说明启动服务器（或让 Claude 启动它）。
2. 打开您的 Claude 配置文件：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 在 mcpServers 键下添加 Warpcast 服务器。替换路径为该存储库的位置：

{
  "mcpServers": {
    "warpcast": {
      "command": "uvicorn",
      "args": [
        "--app-dir",
        "/ABSOLUTE/PATH/TO/mcp-warpcast-server",
        "main:app",
        "--port",
        "8000"
      ],
      "url": "http://localhost:8000/mcp",
      "env": {
        "WARPCAST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

指定 url 告诉 Claude Desktop 通过 HTTP 使用 Server-Sent Events 与服务器通信，而不是标准输入和输出。 如果您省略 url，Claude Desktop 默认通过标准输入和输出（stdio）进行通信，这将无法与该服务器正常工作。

4. 保存文件并重新启动 Claude Desktop。您现在应该在聊天输入中看到一个锤子图标，可以使用 Warpcast 工具。

运行测试

单元测试使用 pytest 编写，并使用 FastAPI 的 TestClient（通过 fastapi[testclient] 安装）。 创建虚拟环境，安装依赖项并运行测试套件：

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
make test        # 或者直接 `pytest`

测试模拟 Warpcast API 层，因此不需要网络连接。

MCP 兼容性

此服务器使用官方 MCP Python SDK，并完全兼容 模型上下文协议。客户端可以通过 FastMCP 提供的 /mcp 端点连接并与这里定义的工具进行交互。

许可证

本项目根据 MIT 许可证发布。