OpenFinance MCP Server

OpenFinance MCP Server

OpenFinance MCP Server は、Pluggy.ai を通じてブラジルのオープンファイナンス・エコシステムに接続する Go ベースのアプリケーションです。口座残高、取引、投資などの金融データに、安全で構造化された形でアクセスできます。これらのリソースを Model Context Protocol (MCP) 経由で大規模言語モデル（LLM）やその他の AI エージェントに公開し、インテリジェントな金融アプリケーションの開発を促進するよう設計されています。

注：使用前に、Pluggy Connect で必要な同意を付与してください。

インストール

1. リポジトリをクローンします：

git clone https://github.com/thunderjr/openfinance-mcp-server.git
cd openfinance-mcp-server

2. 依存関係をインストールします：

go mod tidy

3. サーバーをビルドします：

make build

4. お好みの MCP クライアント（例：Claude Desktop）でバイナリを使用します：

{
  "mcpServers": {
    "openfinance-mcp-server": {
      "command": "<project_path>/bin/openfinance-mcp-server",
      "args": [],
      "env": {
        "PLUGGY_CLIENT_ID": "${PLUGGY_CLIENT_ID}",
        "PLUGGY_CLIENT_SECRET": "${PLUGGY_CLIENT_SECRET}"
      }
    }
  }
}

認証情報の保存

初回起動時に、サーバーは PLUGGY_CLIENT_ID／PLUGGY_CLIENT_SECRET（環境変数、または ~/.config/finops/pluggy.json）を一度だけ読み込み、暗号化された SQLite データベース ~/.openfinance/pluggy.db に登録します。その後はデータベースが信頼できる唯一の情報源となり、すべてのシークレット（認証情報、キャッシュされた API キー、接続トークン）は保存時に AES-256-GCM で暗号化されます。

AES マスターキーは、次の順に取得されます：$OPENFINANCE_DB_KEY（base64）→ OS キーチェーン （初回起動時に自動生成）→ ~/.openfinance/master.key（0600 のフォールバック）。外部サービスは必要ありません。

mcporter でのツールの呼び出し

# Register once (stdio → built binary)
npx mcporter config add openfinance \
  --command "<project_path>/bin/openfinance-mcp-server" --scope home

npx mcporter list openfinance --schema      # show tool signatures
npx mcporter call openfinance.list_connections

🤝 コントリビューション

コントリビューションを歓迎します！リポジトリをフォークし、変更を加えたうえでプルリクエストを送信してください。