MCPサーバーを超えて

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

特徴

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

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

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

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

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

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

• Farcaster : Neynar API を介した完全な実装

• Twitter : プレースホルダー（実装されていません）

はじめる

前提条件

• Node.js 16以上

• Neynar API キー (Farcaster アクセス用) https://neynar.com/

インストール

1. リポジトリをクローンする

2. 依存関係をインストールする

3. テンプレートから.envファイルを作成する

4. 環境変数を設定する

   • 必須: .env ファイルにNEYNAR_API_KEYを設定する

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

   • 有効なAPIキーがないと、Farcasterの機能は動作しません

5. サーバーを構築して起動する

Claude for Desktop と併用

1. サーバーを構築する

2. .env ファイルが API キーで適切に設定されていることを確認してください

   • サーバーは次の場所で .env を検索します。

     • 現在の作業ディレクトリ

     • プロジェクトのルートディレクトリ

     • 親ディレクトリ（最大3レベル）

   • システム内で直接環境変数を設定することもできます

3. 次の場所で、Claude Desktop 構成にサーバーを追加します。

• macOS: ~/ライブラリ/アプリケーションサポート/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

4. あるいは、API キーとその他の環境変数を Claude Desktop 構成で直接渡すこともできます (推奨)。

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. プロバイダーをレジストリに登録する

例：

発達

開発モードで実行

テスト

リンティング

ライセンス

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

貢献

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

変更履歴

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

[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 の強化

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