sc-mcp

あなたの Scalable Capital 証券口座を、任意の MCP 対応アシスタントに接続します。このサーバーは、Scalable Capital の公式 sc CLI をラップした、読み取り専用の軽量ラッパーです。エージェントは、Claude Code、Claude Desktop、Codex、Cursor、VS Code 全体で同じ設定を使用して、ポートフォリオ、取引、分析、相場、チャート、ウォッチリスト、アラートを取得できます。

機能

• ライブブローカーデータ — 概要、保有銘柄、取引、分析、現金内訳、パフォーマンスチャート、相場、証券ニュース。

• ポートフォリオ管理の追加機能 — ウォッチリスト、価格アラート、ポートフォリオグループ、積立計画設定。

• デフォルトで高速 — 読み取り応答は SQLite ファイルにキャッシュされます（再起動後も保持、設定 を参照）。

• 安全性第一 — 取引や注文は行いません。書き込みツールはオプトインしない限り無効です。送金コマンドは設計上存在しません。

• どこでも実行可能 — デスクトップクライアント用のプレーンな stdio、リモートアクセス用の HTTP、または完全に自己完結型の Docker イメージ。

[!Warning] 非公式です。 Scalable Capital の sc CLI をラップしたコミュニティ製ラッパーであり、Scalable Capital とは提携しておらず、その承認も受けていません。公式の MCP サーバーが提供されるまでの暫定的なものであり、提供され次第、廃止される可能性があります。

無保証。 MIT ライセンスの下で「現状のまま」提供されます。損失、損害、誤ったデータ、または金銭的な結果について一切の責任を負いません。これは金融アドバイスではありません。行動を起こす前に内容を確認してください。

ツール

読み取り専用ツールはブローカーに直接アクセスします。成功した応答は、再起動後も保持される SQLite ファイルに 5 分間（設定可能）キャッシュされます。

⚠️ = SC_MCP_ENABLE_WRITES=true が必要、デフォルトではオフ。

sc CLI は trade および savings-plans add/remove も公開しています。これらは意図的に公開していません — 送金コマンドは完全に範囲外です（上記の書き込みツールはウォッチリスト、アラート、グループのみを扱います）。

クイックスタート

以下のいずれかの方法を選択してください。すべての方法で動作するサーバーが得られます。

Claude Code プラグイン

/plugin marketplace add NinjaEde/mcp-scalable-capital
/plugin install sc-mcp

これにより、scalable-capital MCP サーバーと、Claude にツールの使用方法とタイミングを指示するスキルが登録されます。

uvx ワンライナー

uvx --from git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0 sc-mcp

任意の MCP クライアントをそのコマンドに指定します（sc-mcp は stdio で起動します。タグは バージョニング に従って固定してください）。

要件

1. PATH に uv が存在すること — Docker を使用する場合は不要です。

2. PATH に sc CLI が存在すること（認証 を参照）。

3. 認証済みセッション: sc login（認証 を参照）。

Docker は CLI とこのサーバーの両方をバンドルしているため、手動で行う必要があるのは以下のログインのみです。

認証

すべての sc_* ツールは Scalable Capital の公式 sc CLI を呼び出します。この CLI はマシンごとに（または Docker ボリュームごとに）インストールされ、かつログインされている必要があります。

CLI のインストール

macOS（Homebrew）:

brew install scalablecapital/tap/scalable-cli

Linux（Docker イメージに組み込まれているバイナリも同様）: アーキテクチャに合った公式ビルドをダウンロードし、sc を PATH に配置します:

ARCH=$(uname -m)   # x86_64 or aarch64
curl -fSL "https://github.com/ScalableCapital/scalable-cli/releases/download/v0.6.0/sc-v0.6.0-linux-${ARCH}-gnu.tar.gz" -o /tmp/sc.tar.gz
tar xzf /tmp/sc.tar.gz -C /tmp
sudo install -m 0755 /tmp/sc-v0.6.0-linux-${ARCH}-gnu/sc /usr/local/bin/sc

確認:

sc --version   # e.g. "sc 0.6.0"

ログイン（1回のみ）

sc login       # device flow: open the printed URL, confirm, done
sc whoami      # confirm the session works

後でツールが "セッションの有効期限が切れた可能性があります — sc login を実行してください" と報告した場合は、sc login を再実行してください。

セッションの保存場所

~/.config/scalable-cli/:

ヘッドレス / キーリングなし環境（Docker、CI、サーバー）: CLI はデフォルトで OS のキーリングを使用します。キーリングがない場合は、プレーンファイルを指定します（Docker イメージは docker/entrypoint.sh で自動的にこれを行います）:

# ~/.config/scalable-cli/config.toml
[auth]
session_backend = "file"

その後、sc login を再度実行します。セッションは session.json に保存され、再起動後も保持されます。

ヒント: コンテナ内でホストセッションを再利用して、2回ログインする手間を省くことができます:

docker cp ~/.config/scalable-cli/session.json sc-mcp:/home/sc/.config/scalable-cli/session.json
docker compose restart

そのファイルはパスワードと同様に扱い、決してコミットしないでください。

クライアントとの統合

Claude Code（手動）

claude mcp add scalable-capital -- uvx --from git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0 sc-mcp

Cursor

Cursor に追加 — または .cursor/mcp.json（または ~/.cursor/mcp.json）に追加:

{
  "mcpServers": {
    "scalable-capital": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0", "sc-mcp"]
    }
  }
}

Codex

~/.codex/config.toml に追加:

[mcp_servers.scalable-capital]
command = "uvx"
args = ["--from", "git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0", "sc-mcp"]

Claude Desktop（バンドル、設定編集不要）

sc-mcp.mcpb をダウンロードし、Claude Desktop で 設定 → 拡張機能 → 拡張機能をインストール に進み、ファイルを選択します。

[!Note] Claude Desktop が uvx を見つけられない場合は、拡張機能の設定を開き、フルパス（例: /opt/homebrew/bin/uvx）を設定してください。macOS の GUI アプリは、シェルの PATH を常に継承するとは限りません。

VS Code / その他の MCP クライアント

{
  "mcpServers": {
    "scalable-capital": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0", "sc-mcp"]
    }
  }
}

@v0.2.0 タグを固定してください（バージョニング を参照）。タグを削除すると、最新の main を追跡します。

Docker

スタック全体（このサーバー および sc CLI）はコンテナ内で実行されるため、Docker のみが必要です（ローカルに uv、Python、sc は不要）:

docker compose up -d --build              # build + start on http://localhost:8000/mcp
docker compose run --rm sc-login          # first time only — interactive device flow

セッションは sc-cli-config ボリュームに保存され、再起動後も保持されます。docker-compose.yml で SC_MCP_ENABLE_WRITES: "true" を設定しない限り、書き込みは無効のままです。

HTTP 対応の MCP クライアントをサーバー URL に指定します:

{
  "mcpServers": {
    "scalable-capital": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

コンテナは scalable.capital に直接通信します。sc login からのデバイスフロー URL はホスト上と同じように機能します。ブラウザで開いてください。イメージには既に session_backend = "file" 設定が含まれています（認証 を参照）。

互換性

sc 0.6.x でテスト済み。CLI は 1.0 未満であり、そのコマンドサーフェスはマイナーバージョン間で変更される可能性があります。サーバーは起動時に、インストールされている sc がテスト済みのメジャー.マイナーと異なる場合、stderr に警告をログ出力します。sc は外部バイナリであり、Python の依存関係ではないため、これが唯一可能な対応です。警告が表示され、ツールが誤動作する場合、不一致が原因である可能性が高いです。

設定

開発

uv sync
uv run sc-mcp          # starts the stdio server
# or
SC_MCP_TRANSPORT=streamable-http uv run sc-mcp
uv run pytest

sc との同期を維持する方法（ツールの追加/更新、SUPPORTED_SC_VERSION のバンプ、読み取り専用の不変条件）は CLAUDE.md に文書化されています。

バージョニング

SemVer — ツールが公開 API です:

リリースは vX.Y.Z でタグ付けされます。uvx --from git+... でインストールする場合はタグを固定してください。そうしないと、デフォルトブランチを追跡し、ツールサーフェスが予告なく変更される可能性があります。ほとんどのバンプは sc CLI の変更によって引き起こされます（互換性 を参照）。バージョンはこのパッケージ自体のものであり、sc のバージョンではありません。

ライセンス

MIT