Fedspeak MCP Server

🚀 連邦準備制度理事会声明MCPサーバー

このサーバーは、連邦公開市場委員会（FOMC）声明のアクセスと分析を行うためのモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このサーバーは、連邦公開市場委員会（FOMC）声明のアクセスと分析のためのモデルコンテキストプロトコル（MCP）インターフェースを提供します。ユーザーは、セマンティック検索や分析を行うことができ、クリーンでツール化されたインターフェースの背後でデータの検索と処理のすべての複雑さを自動的に処理します。

✨ 主な機能

• 声明の検索：テーマ、日付、または内容のセマンティクスに基づいて、連邦準備制度理事会の声明を検索します。
• メタデータのアクセス：利用可能な声明に関する情報を取得します。
• トレンド分析：連邦準備制度理事会の声明の言語の経時的なトレンドを分析します。
• リソースのアクセス：完全な声明内容をリソースとしてアクセスします。
• プロンプトテンプレート：一般的な分析タスクに使用するための事前定義されたプロンプトテンプレートを利用します。

📦 インストール

前提条件

• Python 3.10以上
• FOMCデータベースへのアクセス権を持つ、実行中のプライベートAPIサーバー

ソースコードからのインストール

# リポジトリをクローンする
git clone https://github.com/yourusername/fomc-mcp-server.git
cd fomc-mcp-server

# 仮想環境を作成する
python -m venv venv
source venv/bin/activate  # Windowsの場合：venv\Scripts\activate

# パッケージをインストールする
# pipを使用してインストールする
pip install .

# 推奨：UVを使用してインストールする（依存関係のバージョンを正確にするため）
uv pip install .

📚 ドキュメント

設定

サーバーは、環境変数を使用して設定することができます。

• FEDSPEAK_API_ENDPOINT：バックエンドAPIサービスのデータ操作URL（デフォルト："https://fedspeak-mcp-backend-671377599496.us-central1.run.app"）
• LOG_LEVEL：ログレベル（デフォルト："INFO"）
• LOG_FILE：ログファイルのパス（デフォルト："fedspeak_mcp_server.log"）

注意：データアクセスの追加設定は必要ありません。すべての必要な接続は、サーバーによって自動的に処理されます。

使用方法

サーバーの起動

# 直接実行する
python -m fedspeak

# または、インストールされたスクリプトを使用する
fedspeak

Claudeデスクトップ版との連携

Claudeデスクトップ版と一緒に使用するには、このサーバーをClaudeの設定ファイルに追加してください。 macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fedspeak": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/mk/Documents/Python/AI Playground/mcp/fedspeak/src/fedspeak",
        "run",
        "fedspeak"
      ],
      "env": {
        "FEDSPEAK_API_ENDPOINT": "https://fedspeak-mcp-backend-671377599496.us-central1.run.app"
      }
    }
  }
}

注意：この設定では、UVを使用してsrcベースのパッケージ構造でfedspeakサーバーを実行します。APIエンドポイントは、すべてのデータベース操作とFOMC声明の検索を処理するCloud Runバックエンドサービスに接続します。

利用可能なツール

• search_fomc_statements：連邦準備制度理事会の声明を検索します。
• get_fomc_metadata：利用可能なFOMC声明のメタデータを取得します。
• analyze_fomc_trends：連邦準備制度理事会の言語の経時的な変化トレンドを分析します。
• get_latest_statement：最新のFOMC声明とその完全なテキストを取得します。

利用可能なプロンプト

• search-guidance：FOMC声明を効果的に検索する方法
• analyze-trends-guidance：FOMCの言語の経時的なトレンドを分析する方法
• latest-statement-analysis：最新のFOMC声明を分析する方法

📄 ライセンス

MIT