MCPサーバーを超えて
ソーシャルプラットフォームデータとオンチェーンデータへの標準化されたアクセスを提供する、拡張可能なモデルコンテキストプロトコルサーバーです。現在、Twitter統合用のプレースホルダーを備えたFarcaster(Neynar API経由)をサポートしています。Telegramなどのオンチェーンデータを含む他のプラットフォームにも近日中に追加される予定です。
特徴
MCP準拠: モデルコンテキストプロトコル仕様を完全に実装
マルチプラットフォーム: 複数のソーシャルメディアプラットフォームをサポートするように設計されています
拡張可能: 新しいプラットフォームプロバイダーを簡単に追加できます
適切にフォーマット: LLM の使用に最適化されたコンテキスト フォーマット
柔軟なトランスポート: stdio と SSE/HTTP トランスポートの両方をサポート
Related MCP server: MCP Salesforce Connector
サポートされているプラットフォーム
Farcaster : Neynar API を介した完全な実装
Twitter : プレースホルダー(実装されていません)
はじめる
前提条件
Node.js 16以上
Neynar API キー (Farcaster アクセス用) https://neynar.com/
インストール
リポジトリをクローンする
git clone https://github.com/yourusername/beyond-mcp-server.git
cd beyond-mcp-server依存関係をインストールする
npm installテンプレートから.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 modeClaude for Desktop と併用
サーバーを構築する
npm run build.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 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 の強化
信頼性とパフォーマンスを確保するための包括的なテストを追加
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.