MCPサーバーを超えて

ソーシャルプラットフォームデータとオンチェーンデータへの標準化されたアクセスを提供する、拡張可能なモデルコンテキストプロトコルサーバーです。現在、Twitter統合用のプレースホルダーを備えたFarcaster（Neynar API経由）をサポートしています。Telegramなどのオンチェーンデータを含む他のプラットフォームにも近日中に追加される予定です。

特徴

• MCP準拠: モデルコンテキストプロトコル仕様を完全に実装

• マルチプラットフォーム: 複数のソーシャルメディアプラットフォームをサポートするように設計されています

• 拡張可能: 新しいプラットフォームプロバイダーを簡単に追加できます

• 適切にフォーマット: LLM の使用に最適化されたコンテキスト フォーマット

• 柔軟なトランスポート: stdio と SSE/HTTP トランスポートの両方をサポート

Related MCP server: MCP URL Fetcher

サポートされているプラットフォーム

• 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を設定する

   • Neynar APIキーはhttps://neynar.com/から取得できます。

   • 有効な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: ~/ライブラリ/アプリケーションサポート/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. あるいは、API キーとその他の環境変数を Claude Desktop 構成で直接渡すこともできます (推奨)。

{
  "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を再起動する

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

ツール

• 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 - ウォレットアドレスに基づいてプロファイルを取得する

プロンプト

• analyze-thread - ソーシャルメディアのスレッドを分析する

• summarize-user-activity - ユーザーのアクティビティを要約する

• explore-trending-topics - プラットフォーム上のトレンドトピックを探索する

• analyze-search-results - クエリの検索結果を分析する

• explore-trending-feed - さまざまなプロバイダーのトレンドフィードコンテンツを分析します

• get-wallet-profile - ウォレットアドレスでユーザープロファイルを取得して分析する

• check-user-balance - ユーザーのウォレット残高と保有資産を分析する

  • FIDとユーザー名の両方の入力に対応

  • ユーザー名の自動FID解決を処理します

新しいプロバイダーによる拡張

新しいソーシャル プラットフォーム プロバイダーを追加するには:

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

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

変更履歴

このプロジェクトに対するすべての注目すべき変更はこのファイルに記録されます。

[1.0.0] - 2025年3月10日

追加した

• 初回リリース

• Neynar API を介した Farcaster の統合

• MCP準拠のサーバー実装

• stdioとHTTPモードの両方をサポート

[1.0.1] - 2025年3月19日

追加した

• ウォレットアドレスでユーザープロファイルを取得するための新しいツールとリソースを追加しました

• 新しいテストを追加しました

[1.0.2] - 2025年3月21日

追加した

• IDまたはユーザー名でFarcasterユーザーのウォレット残高を取得する機能を追加しました

• トレンドフィードコンテンツのマルチプロバイダーサポートを実装しました

• 追加のユーザー詳細を含む updateUserProfile の強化

• 信頼性とパフォーマンスを確保するための包括的なテストを追加