🚀 Farcaster MCP 服务器

Farcaster MCP 服务器是一个提供与 Farcaster 网络（farcaster.xyz）交互工具的 MCP 服务器，允许 AI 模型获取、搜索和分析内容。

🚀 快速开始

本服务器允许 AI 模型获取、搜索和分析 Farcaster 网络上的内容，下面将为你介绍其安装和使用方法。

✨ 主要特性

• 获取用户帖子：通过 FID 检索特定 Farcaster 用户的帖子。
• 获取用户名的帖子：通过用户名检索特定 Farcaster 用户的帖子。
• 获取频道的帖子：通过频道名称或 URL 检索特定 Farcaster 频道的帖子。

📦 安装指南

# 克隆仓库
git clone https://github.com/manimohans/farcaster-mcp.git
cd farcaster-mcp

# 安装依赖项
npm install

# 构建项目
npm run build

💻 使用示例

运行服务器

npm start

与 MCP Inspector 结合使用

npx @modelcontextprotocol/inspector node ./build/index.js

与 Claude for Desktop 结合使用

1. 安装 Claude for Desktop。
2. 打开你的 Claude for Desktop 配置文件（位置根据系统不同）：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 添加以下配置：

{
  "mcpServers": {
    "farcaster": {
      "command": "node",
      "args": ["/absolute/path/to/farcaster-mcp/build/index.js"]
    }
  }
}

4. 重启 Claude for Desktop。

与 Smithery 结合使用

此项目包含用于轻松部署的 Smithery 配置文件：

# 安装 Smithery CLI
npm install -g @smithery/cli

# 部署到 Smithery（指定客户端，例如 claude）
npx @smithery/cli install @manimohans/farcaster-mcp --client claude

可用的客户端选项：claude, cline, windsurf, roo - cline, witsy, enconvo。

可用工具

get - user - casts

通过 FID（Farcaster ID）检索特定 Farcaster 用户的帖子。 参数：

• fid：Farcaster 用户 ID（数字）
• limit（可选）：要返回的最大帖子数（默认：10） 示例查询："Show me the latest casts from FID 6846." → "显示 FID 6846 用户的最新帖子。"

get - username - casts

通过用户名检索特定 Farcaster 用户的帖子。 参数：

• username：Farcaster 用户名（字符串）
• limit（可选）：要返回的最大帖子数（默认：10） 示例查询："Show me the latest casts from username 'mani'." → "显示用户名 'mani' 的最新帖子。"

get - channel - casts

通过频道名称或 URL 检索特定 Farcaster 频道的帖子。 参数：

• channel：频道名称或 URL（字符串）
• limit（可选）：要返回的最大帖子数（默认：10） 示例查询："Show me the latest casts from the 'aichannel' channel." → "显示 'aichannel' 频道的最新帖子。"

📚 详细文档

Smithery 配置

此仓库包含用于 Smithery 的所有必要配置文件：

• smithery.yaml：用于 Smithery 部署的 YAML 配置。
• smithery.json：用于 Smithery 功能的 JSON 配置。
• Dockerfile：用于 Smithery 部署的容器配置。

API 详细信息

此实现使用 Farcaster Hubble API 来获取数据。

🔧 技术细节

开发

# 在开发模式下运行
npm run dev