MCP 服务器

Warpcast MCP Server

一个模型上下文协议服务器，允许 Claude 与 Warpcast 账户互动，从而可以通过自然语言执行诸如发布广播 (casts)、阅读内容、按关键词搜索以及管理频道互动等操作。

README

Warpcast MCP 服务器

一个用于 Warpcast 集成的模型上下文协议 (MCP) 服务器，允许你使用 Claude 与你的 Warpcast 帐户进行交互。

功能

向你的 Warpcast 帐户发布消息 (casts)
从 Warpcast 读取消息 (casts)
按关键词或标签搜索消息 (casts)
浏览和互动频道
关注/取消关注频道
获取热门消息 (casts)

设置

克隆此仓库

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

安装依赖
```
npm install
```

生成 API 密钥并配置身份验证

此 MCP 服务器提供了一个辅助脚本来生成必要的 Ed25519 密钥对：

npm run generate-keys

按照提示进行操作：

生成一个随机的 Ed25519 密钥对
将密钥保存到你的 .env 文件
获取有关在 Warpcast 中注册密钥的说明

或者，如果你更喜欢手动设置：

选项 1：使用签名密钥请求

生成一个 Ed25519 密钥对
使用 Warpcast 签名密钥请求 API 请求允许代表你的帐户签署消息
在 Warpcast 应用程序中完成授权

这是一个示例实现：

import * as ed from '@noble/ed25519';
import { mnemonicToAccount, signTypedData } from 'viem/accounts';
import axios from 'axios';

// Generate a keypair
const privateKey = ed.utils.randomPrivateKey();
const publicKeyBytes = await ed.getPublicKey(privateKey);
const key = '0x' + Buffer.from(publicKeyBytes).toString('hex');

// EIP-712 domain and types for SignedKeyRequest
const SIGNED_KEY_REQUEST_VALIDATOR_EIP_712_DOMAIN = {
  name: 'Farcaster SignedKeyRequestValidator',
  version: '1',
  chainId: 10,
  verifyingContract: '0x00000000fc700472606ed4fa22623acf62c60553',
};

const SIGNED_KEY_REQUEST_TYPE = [
  { name: 'requestFid', type: 'uint256' },
  { name: 'key', type: 'bytes' },
  { name: 'deadline', type: 'uint256' },
];

// Generate a Signed Key Request signature
const appFid = process.env.APP_FID;
const account = mnemonicToAccount(process.env.APP_MNEMONIC);

const deadline = Math.floor(Date.now() / 1000) + 86400; // signature is valid for 1 day
const signature = await account.signTypedData({
  domain: SIGNED_KEY_REQUEST_VALIDATOR_EIP_712_DOMAIN,
  types: {
    SignedKeyRequest: SIGNED_KEY_REQUEST_TYPE,
  },
  primaryType: 'SignedKeyRequest',
  message: {
    requestFid: BigInt(appFid),
    key,
    deadline: BigInt(deadline),
  },
});

// Create a Signed Key Request
const warpcastApi = 'https://api.warpcast.com';
const { token, deeplinkUrl } = await axios
  .post(`${warpcastApi}/v2/signed-key-requests`, {
    key,
    requestFid: appFid,
    signature,
    deadline,
  })
  .then((response) => response.data.result.signedKeyRequest);

console.log('Deep link URL:', deeplinkUrl);
console.log('Open this URL on your mobile device with Warpcast installed to authorize this key');

选项 2：使用现有的 App Key

如果你已经为你的 Farcaster 帐户设置了 App Key，你可以直接使用 FID、私钥和公钥。

构建服务器
```
npm run build
```
配置 Claude for Desktop 以使用此服务器

使用 Claude for Desktop 进行配置

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "warpcast": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-warpcast-server/build/index.js"
      ],
      "env": {
        "WARPCAST_FID": "your_fid_here",
        "WARPCAST_PRIVATE_KEY": "your_private_key_here",
        "WARPCAST_PUBLIC_KEY": "your_public_key_here"
      }
    }
  }
}