MCPサーバーを超えて
ソーシャルプラットフォームデータとオンチェーンデータへの標準化されたアクセスを提供する、拡張可能なモデルコンテキストプロトコルサーバーです。現在、Twitter統合用のプレースホルダーを備えたFarcaster（Neynar API経由）をサポートしています。Telegramなどのオンチェーンデータを含む他のプラットフォームにも近日中に追加される予定です。
特徴
- MCP準拠: モデルコンテキストプロトコル仕様を完全に実装
- マルチプラットフォーム: 複数のソーシャルメディアプラットフォームをサポートするように設計されています
- 拡張可能: 新しいプラットフォームプロバイダーを簡単に追加できます
- 適切にフォーマット: LLM の使用に最適化されたコンテキスト フォーマット
- 柔軟なトランスポート: stdio と SSE/HTTP トランスポートの両方をサポート
サポートされているプラットフォーム
- Farcaster : Neynar API を介した完全な実装
- Twitter : プレースホルダー（実装されていません）
はじめる
前提条件
インストール
- リポジトリをクローンする
git clone https://github.com/yourusername/beyond-mcp-server.git
cd beyond-mcp-server
- 依存関係をインストールする
- テンプレートから.envファイルを作成する
cp .env.example .env
# Edit .env with your API keys
- 環境変数を設定する
- 必須: .env ファイルに
NEYNAR_API_KEYを設定する - Neynar APIキーはhttps://neynar.com/から取得できます。
- 有効なAPIキーがないと、Farcasterの機能は動作しません
- サーバーを構築して起動する
npm run build
npm start # For stdio mode (default)
# OR
npm run start:http # For HTTP/SSE mode
Claude for Desktop と併用
- サーバーを構築する
- .env ファイルが API キーで適切に設定されていることを確認してください
- サーバーは次の場所で .env を検索します。
- 現在の作業ディレクトリ
- プロジェクトのルートディレクトリ
- 親ディレクトリ（最大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"
]
}
}
}
- あるいは、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"
}
}
}
}
- デスクトップ版の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解決を処理します
新しいプロバイダーによる拡張
新しいソーシャル プラットフォーム プロバイダーを追加するには:
src/providers/に新しいディレクトリを作成します。ContentProviderインターフェースを実装する- プロバイダーをレジストリに登録する
例：
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 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 の強化
- 信頼性とパフォーマンスを確保するための包括的なテストを追加