自発的、読み取り専用金融市場**MCP(AIクライアント向け標準のモデルコンテキストプロトコル)**台湾上場有価証券およびグローバル株式のサーバー。 市場データを取得し、再現可能な指標を計算します。投資の決定や取引場所を作るものではありません。

営業部

#このリポジトリが存在する理由

独自のインスタンスを実行します。 このプロジェクトは、他のユーザーをメンテナーのサーバーにルーティングし、API認証をバンドルし、OpenConnectorを要求するか、ホストされたアカウントが必要です。

• パブリックデフォルトでは、FinMind と Finnhub をローカル [.env] の認証情報に直接呼び出します。
• FinMindは任意で、低い限界の無声アクセスを支えます。 Finnhub-backed ツールは、独自の API キーが必要です。
• 高度なデプロイメントは、OpenConnector アダプターを選択するので、このプロセスは狭いランタイムトークンのみを保持します。
• [.env, OAuth 状態, プライベートキー, SQLite データベース, 生成された認証情報は Git によって無視されます。

##3ステップ自走

Finnhub API キーを入力するには、シェル履歴で説明せずに、インタラクティブヘルパーを使用して、サービスを再始動するかどうかを選択します。

ローカルサービスの両方を確認します。

• OAuth なしの内部 MCP: [http://127.0.0.1:8010/mcp

Pipe Stock Analysis

Self-hostable, read-only financial-market MCP (Model Context Protocol, a standard for AI clients to invoke external tools) server for Taiwan-listed securities and global stocks. It retrieves market data and computes reproducible indicators; it does not make investment decisions or place trades.

繁體中文

Why this repository exists

Run your own instance. This project does not route other people to the maintainer’s server, bundle API credentials, require OpenConnector, or require a hosted account.

• The public default calls FinMind and Finnhub directly with credentials from your local .env.
• FinMind is optional and supports anonymous access with lower limits. Finnhub-backed tools require your own API key.
• Advanced deployments can select the OpenConnector adapter so this process holds only a narrow runtime token.
• .env, OAuth state, private keys, SQLite databases, and generated credentials are ignored by Git.

Three-step self-hosting

# 1. Clone
git clone https://github.com/Gratia2533/pipe-stock-analysis.git && cd pipe-stock-analysis

# 2. Create local configuration; optionally add FINMIND_TOKEN / FINNHUB_API_KEY
cp .env.example .env

# 3. Start with the default Direct adapter on a standard Docker bridge network
docker compose up -d --build

To enter a Finnhub API key without exposing it in shell history, use the interactive helper and choose whether to restart the services:

./scripts/set-finnhub-key.sh

Verify both local services:

curl http://127.0.0.1:8010/healthz
curl http://127.0.0.1:8011/healthz

• Internal MCP without OAuth: http://127.0.0.1:8010/mcp
• OAuth-protected MCP: http://127.0.0.1:8011/mcp

Both endpoints are published only on 127.0.0.1. Keep port 8010 private; expose only port 8011 through a public HTTPS reverse proxy or tunnel.

Data backends

Direct (default)

DATA_BACKEND=direct
FINMIND_TOKEN=
FINNHUB_API_KEY=

The service starts without either optional credential, so TWSE, TPEx, MOPS, news, and deterministic analytics remain available. FinMind uses anonymous limits when its token is empty. A Finnhub tool reports a configuration error only when called without FINNHUB_API_KEY.

OpenConnector (advanced, Linux/WSL)

Use this mode when a dedicated OpenConnector already exposes the curated FinMind and Finnhub Actions. The advanced Compose injects only its runtime token; upstream credentials remain in OpenConnector’s encrypted credential store. For fail-closed separation, FINMIND_TOKEN and FINNHUB_API_KEY must be unset in this mode.

DATA_BACKEND=openconnector
OPEN_CONNECTOR_BASE_URL=http://127.0.0.1:8001
OPEN_CONNECTOR_RUNTIME_TOKEN=your-local-runtime-token

Because a bridged container cannot reach a connector bound to host loopback, the advanced Compose file intentionally uses Linux/WSL host networking while both services remain bound to 127.0.0.1: