Self-hostable, read-only 금융 시장 ** MCP (모델 콘텍스트 프로토콜, AI 클라이언트의 표준은 외부 도구를 통합) ** 대만 상장 증권 및 글로벌 주식을위한 서버. 시장 데이터를 검색하고 재현 가능한 지표를 계산합니다. 투자 결정이나 장소 거래를하지 않습니다.

한국어

왜 이 저장소 존재

자신의 인스턴스를 실행합니다. 이 프로젝트는 ** 유지자의 서버에 다른 사람들을 경로, 번들 API 자격 증명, OpenConnector 필요, 또는 호스팅 계정이 필요합니다.

• 공공 기본 통화 FinMind 및 Finnhub는 로컬 .env에서 자격 증명으로 직접 호출합니다.
• FinMind는 옵션이며 익명 액세스를 지원합니다. Finnhub 백업 도구는 자신의 API 키가 필요합니다.
• 고급 배포는 OpenConnector 어댑터를 선택하여이 프로세스는 좁은 런타임 토큰 만 보유합니다.
• .env, OAuth 상태, 개인 키, SQLite 데이터베이스 및 생성 된 자격은 Git에 의해 무시됩니다.

세 단계 자체 호스팅

Finnhub API 키를 입력하려면 Shell History에서 exposing하지 않고 대화 형 헬퍼를 사용하고 서비스를 재시작하는지 선택하십시오.

로컬 서비스를 모두 검증:

• 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: