Самостоятельный, только для чтения финансовый рынок MCP (Model Context Protocol, стандарт для клиентов ИИ для вызова внешних инструментов) сервер для тайваньских ценных бумаг и глобальных акций. Он получает рыночные данные и вычисляет воспроизводимые индикаторы; он не принимает инвестиционных решений или не размещает сделки.

中中

Почему существует этот репозиторий

Управляйте собственным экземпляром. Этот проект не направляет других людей на сервер администратора, связывает учетные данные API, требует OpenConnector или хостинг учетной записи.

Публичный дефолт вызывает FinMind и Finnhub напрямую с учетными данными из вашего местного .env. FinMind является необязательным и поддерживает анонимный доступ с более низкими ограничениями. Инструменты, поддерживаемые Finnhub, требуют собственного API-ключа. Расширенные развертывания могут выбрать адаптер OpenConnector, поэтому этот процесс содержит только узкий маркер времени выполнения. .env, состояние OAuth, закрытые ключи, базы данных SQLite и сгенерированные учетные данные игнорируются Git.

Трехступенчатый самохостинг

Чтобы ввести ключ API Finnhub, не раскрывая его в истории оболочки, воспользуйтесь интерактивным помощником и выберите, перезапустить ли сервисы:

Проверьте оба местных сервиса:

• Внутренняя MCP без OAuth: 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: