Beyond MCP Server

Beyond MCP Server

一个可扩展的模型上下文协议服务，可标准化访问社交平台数据和链上数据。目前支持 Farcaster（通过 Neynar API），并预留了 Twitter 集成接口。很快还将添加更多平台（如 Telegram）以及链上数据支持。

功能

• 符合 MCP 规范：完整实现模型上下文协议规范
• 多平台支持：旨在支持多个社交媒体平台
• 可扩展：易于添加新的平台提供方
• 格式良好：针对大模型使用优化上下文格式
• 传输方式灵活：支持 stdio 和 SSE/HTTP 传输

支持的平台

• Farcaster：通过 Neynar API 完整实现
• Twitter：占位项（尚未实现）

入门指南

前置条件

• Node.js 16+
• Neynar API 密钥（用于访问 Farcaster）https://neynar.com/

安装

1. 克隆仓库

git clone https://github.com/yourusername/beyond-mcp-server.git
cd beyond-mcp-server

2. 安装依赖项

npm install

3. 根据模板创建 .env 文件

cp .env.example .env
# Edit .env with your API keys

4. 配置环境变量

   • 必需：在 .env 文件中设置 NEYNAR_API_KEY
   • 可从 https://neynar.com/ 获取 Neynar API 密钥
   • 没有有效的 API 密钥，Farcaster 功能将无法使用

5. 构建并启动服务

npm run build
npm start  # For stdio mode (default)
# OR
npm run start:http  # For HTTP/SSE mode

与 Claude for Desktop 配合使用

1. 构建服务

npm run build

2. 确保 .env 文件已正确配置 API 密钥

   • 服务将在以下位置查找 .env：
     • 当前工作目录
     • 项目根目录
     • 上级目录（最多 3 层）
   • 也可以直接在系统中设置环境变量

3. 在以下位置的 Claude Desktop 配置文件中添加服务：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "beyond-social": {
      "command": "/usr/local/bin/node",
      "args": [
        "/full/path/to/beyond-mcp-server/dist/index.js",
        "--stdio"
      ]
    }
  }
}

4. 或者，也可以在 Claude Desktop 配置文件中直接传入 API 密钥和其他环境变量（推荐）：

{
  "mcpServers": {
    "beyond-social": {
      "command": "/usr/local/bin/node",
      "args": [
        "/full/path/to/beyond-mcp-server/dist/index.js",
        "--stdio"
      ],
      "env": {
        "NEYNAR_API_KEY": "YOUR_API_KEY_HERE",
        "ENABLE_FARCASTER": "true",
        "ENABLE_TWITTER": "false"
      }
    }
  }
}

5. 重启 Claude for Desktop

MCP 功能

资源

• social://{platform}/{query}/search - 搜索平台上的内容
• social://{platform}/user/{userId}/profile - 获取用户资料
• social://{platform}/wallet/{walletAddress}/profile - 根据钱包地址获取用户资料（仅限 Farcaster）
• social://{platform}/user/{userId}/balance - 获取用户的钱包余额（仅限 Farcaster）
  • 接受 FID（数字）或用户名
  • 如果提供用户名，会在获取余额前自动将其转换为 FID
• social://{platform}/wallet/{walletAddress}/profile - 根据钱包地址获取用户资料
• social://{platform}/user/{userId}/content - 获取用户内容
• social://{platform}/thread/{threadId} - 获取对话串
• social://{platform}/trending - 获取热门话题
• social://{platform}/trending-feed - 获取支持多提供方的热门动态内容（仅限 Farcaster）
  • 支持的提供方：neynar（默认）、openrank、mbd
  • 参数：timeWindow（1h、6h、12h、24h、7d、30d）、limit
• social://{platform}/channels/search - 搜索平台上的频道（仅限 Farcaster）
  • 参数：query、limit、cursor
  • 返回频道详情，包括名称、描述、关注者数量和元数据
• social://{platform}/channels/bulk-search - 并行搜索多个频道（仅限 Farcaster）
  • 参数：queries（数组）、limit、cursor
  • 返回每个查询的结果，包括频道详情和分页信息

工具

• search-content - 搜索社交平台上的内容
• get-user-profile - 获取用户的个人资料信息
• get-user-profile-by-wallet - 使用钱包地址获取用户资料（仅限 Farcaster）
• get-user-balance - 获取用户的钱包余额（仅限 Farcaster）
  • 接受 FID（数字）或用户名
  • 自动处理用户名到 FID 的转换
• get-user-content - 获取特定用户的内容
• get-thread - 获取对话串
• get-trending-topics - 获取当前热门话题
• getTrendingFeed - 获取支持多提供方的热门动态（仅限 Farcaster）
• get-wallet-profile - 根据钱包地址获取个人资料
• search-channels - 搜索平台上的频道（仅限 Farcaster）
  • 参数：query、limit、cursor
  • 返回详细的频道信息，包括关注者数量和元数据
• search-bulk-channels - 并行搜索多个频道（仅限 Farcaster）
  • 参数：queries（数组）、limit、cursor
  • 返回每个查询的结果，包括频道详情和分页信息

提示词

• analyze-thread - 分析社交媒体对话串
• summarize-user-activity - 总结用户的活动
• explore-trending-topics - 探索平台上的热门话题
• analyze-search-results - 分析查询的搜索结果
• explore-trending-feed - 分析不同提供方的热门动态内容
• get-wallet-profile - 根据钱包地址获取并分析用户资料
• check-user-balance - 分析用户的钱包余额和持仓
  • 支持 FID 和用户名输入
  • 自动解析用户名对应的 FID
• explore-channels - 分析并探索平台上的频道
  • 提供有关频道受欢迎程度和内容的见解
  • 根据搜索条件帮助发现相关频道
• explore-bulk-channels - 并行分析和比较多个频道
  • 高效搜索并比较多个频道
  • 提供有关频道关系和趋势的见解

使用新提供方进行扩展

添加新的社交平台提供方：

1. 在 src/providers/ 中创建新目录
2. 实现 ContentProvider 接口
3. 在注册表中注册该提供方

示例：

import { ContentProvider } from '../interfaces/provider';

export class MyPlatformProvider implements ContentProvider {
  public name = 'myplatform';
  public platform = 'myplatform';
  
  // Implement all required methods
}

开发

在开发模式下运行

npm run dev        # stdio mode
npm run dev:http   # HTTP mode

测试

npm test

代码检查

npm run lint
npm run lint:fix

许可证

MIT

贡献

欢迎贡献！请随时提交 Pull Request。

更新日志

本项目的所有重要变更都将记录在此文件中。

[1.0.0] - 2025-Mar-10

新增

• 首次发布
• 通过 Neynar API 集成 Farcaster
• 实现符合 MCP 规范的服务
• 支持 stdio 和 HTTP 两种模式

[1.0.1] - 2025-Mar-19

新增

• 新增通过钱包地址获取用户资料的工具和资源
• 新增测试

[1.0.2] - 2025-Mar-21

新增

• 新增通过 ID 或用户名获取 Farcaster 用户钱包余额的功能
• 为热门动态内容实现多提供方支持
• 扩展 updateUserProfile，加入更多用户详情
• 新增全面的测试，确保可靠性和性能

[1.0.3] - 2025-Mar-24

新增

• 新增获取单个和批量 Farcaster 频道信息的支持