Fedspeak MCP Server

Fedspeak MCP Server

Federal Reserve（FOMC）の声明にアクセスして分析するための Model Context Protocol（MCP）サーバーです。

概要

このサーバーは、Federal Reserve（FOMC）の声明にアクセスして分析するための Model Context Protocol（MCP）インターフェースを提供します。データの取得と処理に伴う複雑さを、シンプルなツールベースのインターフェースの背後で処理しながら、FOMC声明のセマンティック検索と分析を可能にします。

機能

• 声明の検索：トピック、日付、内容を基にFOMC声明をセマンティック検索します
• メタデータへのアクセス：利用可能な声明に関する情報を取得します
• トレンド分析：Fedの声明における言語の傾向を時系列で分析します
• リソースへのアクセス：リソースとして声明の全文にアクセスします
• プロンプトテンプレート：一般的な分析タスク用に事前定義されたプロンプトテンプレートを使用します

インストール

前提条件

• Python 3.10以降
• FOMCデータベースにアクセスできる、稼働中のプライベートAPIサーバー

ソースからインストール

# Clone the repository
git clone https://github.com/yourusername/fomc-mcp-server.git
cd fomc-mcp-server

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
# Install with pip
pip install .

# Install with UV (recommended for exact dependency versions)
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"）

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

使用方法

サーバーの実行

# Run directly
python -m fedspeak

# Or using the installed script
fedspeak

Claude for Desktopでの使用

Claude for Desktopで使用するには、このサーバーを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"
      }
    }
  }
}

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

利用可能なツール

• search_fomc_statements：Federal Reserveの声明をセマンティック検索します
• get_fomc_metadata：利用可能なFOMC声明に関するメタデータを取得します
• analyze_fomc_trends：Federal Reserveの言葉遣いの時系列での傾向を分析します
• get_latest_statement：最新のFOMC声明を全文で取得します

利用可能なプロンプト

• search-guidance：FOMC声明を効果的に検索する方法
• analyze-trends-guidance：FOMCの言葉遣いの時系列での傾向を分析する方法
• latest-statement-analysis：最新のFOMC声明を分析する方法

ライセンス

MIT