finary-mcp

意図的に読み取り専用の Model Context Protocol サーバーであり、Finary 向けに、非公式の finary-uapi クライアント上に構築されています。

[!WARNING] このプロジェクトは Finary とは独立しており、Finary による承認、サポート、保守はされていません。finary-uapi を通じて非公開・未文書化のエンドポイントに依存しており、どちらのプロジェクトも予告なく壊れる可能性があります。これは財務、税金、法律、投資のアドバイスではありません。

安全性モデル

finary-mcp は意図的に、範囲を絞った読み取り専用アダプターです：

• プロフィール、組織、機関、ポートフォリオ、取引のクエリのみを公開します。

• ログイン、アカウントインポート、作成、更新、削除、振替、取引、または汎用 CLI ツールはありません。

• シェルを介さず、固定の許可リストから finary-uapi コマンドを構築します。

• フィルタ値は実行前に検証されます。

• リクエストが失敗した場合、上流の stdout/stderr を返しません。上流のログインフローがセッション情報を出力する可能性があるためです。

• 状態ディレクトリは明示的です（FINARY_MCP_STATE_DIR）。任意の作業ディレクトリからトークンを探すことはありません。

これにより、MCP を通じた偶発的な書き込みが減ります。ただし、別のプロセスがセッションファイルを読み取れる場合、マシンを安全にすることはできません。信頼できるアカウントとプロフィールでのみサーバーを実行してください。

認証に関する重要な注意

「読み取り専用」とは、Finary のポートフォリオデータに関するものです。finary-uapi はリクエストの前に Clerk セッションを更新し、jwt.json を書き換える可能性があります。そのため、MCP ツールが Finary のデータを変更することはないものの、プライベート状態ディレクトリはローカルサービスアカウントから書き込み可能な状態を保つ必要があります。サーバーがそのファイル、Cookie、子プロセスの診断情報を返すことはありません。

finary-uapi は推移的依存関係として GPL-2.0 の fuzzywuzzy も取り込みます。配布またはデプロイを予定している場合は、上流の依存関係グラフとライセンスへの影響を確認してください。

Related MCP server: C6 Bank MCP

前提条件

• Python 3.10+。

• finary-uapi によってすでに作成されたローカルの Finary セッション。

• jwt.json と localCookiesMozilla.txt の両方を含むプライベートディレクトリ。ディレクトリのモードは 0700、ファイルのモードは 0600。

サーバー自体は Google OAuth をサポートしていません。finary-uapi がサポートする認証プロセスに従って、ローカルセッションを作成または更新してください。パスワード、TOTP コード、JWT、Cookie のエクスポート、セッションファイルをエージェント、リポジトリ、課題トラッカー、チャットに送信しないでください。

インストール

python -m venv .venv
. .venv/bin/activate
pip install finary-mcp

チェックアウトからの開発の場合：

pip install -e '.[dev]'
pytest -q

MCP ホストを設定する

FINARY_MCP_STATE_DIR に、Finary セッションを保持するディレクトリを設定します。finary-uapi が別の仮想環境にインストールされている場合は、FINARY_UAPI_PYTHON にその環境の Python 実行ファイルを設定します。

汎用 stdio 設定の例：

{
  "mcpServers": {
    "finary": {
      "command": "/path/to/finary-mcp/.venv/bin/finary-mcp",
      "env": {
        "FINARY_MCP_STATE_DIR": "/private/path/to/finary-state",
        "FINARY_UAPI_PYTHON": "/path/to/finary-uapi/.venv/bin/python"
      }
    }
  }
}

絶対パスを使用してください。状態ディレクトリはプライベートデータであり、決してコミットしてはいけません。同梱の .gitignore は既知のセッションファイルを除外します。

Hermes Agent の例

mcp_servers:
  finary:
    command: /path/to/finary-mcp/.venv/bin/finary-mcp
    env:
      FINARY_MCP_STATE_DIR: /private/path/to/finary-state
      FINARY_UAPI_PYTHON: /path/to/finary-uapi/.venv/bin/python
    tools:
      include:
        - finary_me
        - finary_organizations
        - finary_institution_connections
        - finary_portfolio
        - finary_transactions

資格情報を公開された設定ファイルにコピーするのではなく、Hermes の MCP/設定ワークフローを通じてこれを追加してください。サーバーを追加した後は、ツール検出が再実行されるように Hermes プロセスを再起動してください。

ツール

依存関係: finary-uapi

このプロジェクトは、Finary の API を再実装するものではなく、アダプターです。lasconic/finary_uapi プロジェクトの finary-uapi CLI を呼び出します。そのパッケージは現在 pyproject.toml で finary-uapi>=0.2.3,<0.3 として宣言されています。

この依存関係は、未文書化の Finary エンドポイントを使用し、ローカルセッションを保持します。このサーバーを使用する前に、そのソースとライセンスを確認してください。上流のアップグレードが必要な場合は、まず別の環境でテストし、互換性のあるバージョンをここに固定してください。

開発

pytest -q
python -m build

テストは実際の Finary アカウントを使用せず、セッションファイルを作成してはいけません。公開する前に、ステージングされたファイルに jwt.json、localCookiesMozilla.txt、資格情報、メールアドレス、Cookie、トークンが含まれていないかスキャンしてください。

ライセンス

MIT。LICENSE を参照してください。