mcpField
F
Farcaster Mcp

Farcaster Mcp

本地服务
github.com/argenestel社交媒体071 周前更新
代码仓库

关于 Farcaster Mcp

Farcaster MCP Server 供 MCP 客户端读取 Farcaster 用户的 cast 并发布新内容。发布需要 Farcaster Bearer token；读取无需令牌。

主要功能

  1. 01按 FID 获取 cast
  2. 02按用户名获取 cast
  3. 03发布带可选 URL 嵌入的 cast

适用场景

  1. 01查看 Farcaster 用户的近期帖子
  2. 02通过 MCP 客户端发布 cast

MCP 相关

向 MCP 客户端提供获取用户 cast 和发布 cast 的工具，并通过 stdio 通信。

#farcaster#mcp#server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "farcaster": {
      "command": "npx",
      "args": [
        "-y",
        "github:argenestel/farcaster-mcp"
      ]
    }
  }
}
启动命令npx -y github:argenestel/farcaster-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmgithub:argenestel/farcaster-mcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Farcaster MCP 服务

smithery badge

用于与 Farcaster 交互的模型上下文协议（MCP）服务，可从网络获取 cast 并发布新的 cast。

Farcaster MCP 服务

功能

  • 按 FID 获取 cast：使用 Farcaster 用户的 FID 获取其 cast
  • 按用户名获取 cast：使用 Farcaster 用户名获取其 cast
  • 发布 cast：在 Farcaster 上创建并发布新的 cast（需要身份验证）

环境变量

发布 cast 所需
  • FARCASTER_BEARER_TOKEN：你的 Farcaster API Bearer 令牌
    • 仅在需要使用发布功能时才需要此令牌
    • 不使用此令牌也可执行只读操作
    • 你可以从 Farcaster Client API 获取此令牌
示例
export FARCASTER_BEARER_TOKEN="your_bearer_token_here"

或者创建一个 .env 文件：

FARCASTER_BEARER_TOKEN=your_bearer_token_here

可用工具

get-user-casts

按 FID 获取特定 Farcaster 用户的 cast。

参数：

  • fid（number）：Farcaster 用户 ID（FID）
  • limit（number，可选）：要返回的 cast 数量上限（默认值：10）
get-username-casts

获取特定 Farcaster 用户名的 cast。

参数：

  • username（string）：Farcaster 用户名
  • limit（number，可选）：要返回的 cast 数量上限（默认值：10）
post-cast

在 Farcaster 上发布新的 cast。

参数：

  • cast（string）：要发布的 cast 文本内容
  • embeds（string[]，可选）：要嵌入 cast 的 URL 数组（可选）

**注意：**必须设置 FARCASTER_BEARER_TOKEN 环境变量。

安装

  1. 克隆仓库
  2. 安装依赖： 
    npm install
  3. 构建项目： 
    npm run build
  4. 设置环境变量（如果使用发布功能）

使用

运行服务
npm start

服务将启动，并通过 stdio 监听 MCP 连接。

与 MCP 客户端集成

此服务遵循模型上下文协议规范，可与任何兼容 MCP 的客户端配合使用。

使用的 API 端点

此服务与 Farcaster Client API 交互：

  • 基础 URL：https://client.farcaster.xyz
  • 用户查询：/v2/user-by-username
  • cast 获取：/v2/casts
  • cast 发布：/v2/casts

错误处理

  • 服务提供详细的错误消息，便于调试
  • 妥善处理速率限制和 API 错误
  • 清楚报告缺失的环境变量

安全

  • 通过环境变量安全地处理 Bearer 令牌
  • 不会记录或泄露敏感信息
  • 通过 HTTPS 发起 API 调用

贡献

为本项目贡献代码时，请遵循 DRY、SOLID 和 KISS 原则。

许可证

[在此处添加许可证信息]

Smithery 配置

此仓库包含 Smithery 所需的配置文件：

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

API 详情

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

开发

# Run in development mode
npm run dev

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。