Warpcast

🚀 Warpcast MCP 服务器

本项目是一个用于集成Warpcast的模型上下文协议（MCP）服务器，它允许你借助Claude与自己的Warpcast账户进行交互，实现广播发布、读取、搜索等多种功能。

🚀 快速开始

本服务器可让Claude与Warpcast账户交互，按以下步骤安装配置：

1. 克隆此仓库

   git clone https://github.com/zhangzhongnan928/mcp-warpcast-server.git
   cd mcp-warpcast-server
   

2. 安装依赖项

   npm install
   

3. 生成API密钥并配置身份验证 该MCP服务器提供一个辅助脚本来生成所需的Ed25519密钥对：

   npm run generate-keys
   

   然后打开config.json文件，并将以下环境变量添加到.env文件中：

   _fid=your_farcaster_id
   _public_key=你的公钥
   _private_key=你的私钥
   

4. 运行服务器

   npm start
   

✨ 主要特性

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

💻 使用示例

基础用法

配置完成后，您可以让Claude执行以下操作：

- "发布一条关于[主题]的广播"
- "显示用户[用户名]的最新广播"
- "搜索有关[主题]的广播"
- "显示Warpcast上的热门广播"
- "显示流行的频道"
- "获取[频道]频道的广播"

高级用法

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

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

🔧 技术细节

此服务器使用Warpcast的应用密钥身份验证方法，需要在您的Farcaster账户中注册Ed25519密钥对。身份验证流程如下：

1. 创建包含您的FID和公钥的头
2. 创建带有过期时间的有效载荷
3. 使用您的私钥签名头和有效载荷
4. 使用生成的令牌进行API调用

在生产应用中，建议使用官方的Farcaster SDK来生成身份验证令牌。

📄 许可证

本项目采用MIT许可证。

⚠️ 重要提示

此服务器使用Warpcast的应用密钥身份验证方法，需要在您的Farcaster账户中注册Ed25519密钥对。

💡 使用建议

• 请务必保管好私钥，绝不能泄露
• 考虑定期轮换密钥
• 服务器记录认证错误以帮助调试

🛠️ 故障排除

遇到问题时，您可以：

1. 检查环境变量是否正确设置
2. 确保您的密钥已成功注册到Farcaster账户
3. 查看Claude for Desktop的日志中的任何错误
4. 验证您的Warpcast账户是否有必要的权限