🚀 Farcaster MCP 服务器
一个提供与Farcaster网络（farcaster.xyz）交互工具的MCP服务器，允许AI模型获取、搜索和分析内容。借助此服务器，能便捷地与Farcaster网络进行数据交互，为AI应用提供有力支持。
🚀 快速开始
安装与运行
此服务器提供了多种使用方式，下面为你详细介绍不同场景下的使用方法。
✨ 主要特性
- 获取用户帖子：通过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结合使用
- 安装 Claude for Desktop。
- 打开你的Claude for Desktop配置文件（位置根据系统不同）：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- 添加以下配置：
{
"mcpServers": {
"farcaster": {
"command": "node",
"args": ["/absolute/path/to/farcaster-mcp/build/index.js"]
}
}
}
- 重启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部署的容器配置。
🔧 技术细节
此实现使用Farcaster Hubble API来获取数据。
开发
# 在开发模式下运行
npm run dev