vanoe-intelligence-mcp

Vanoe Market Intelligence MCP サーバー

10 秒で無料の API キーを取得できます：https://api.vanoe.ai/signup?src=mcp-readme — 月 1,000 クレジット、カード不要です。キーのページには、Claude.ai や ChatGPT にコネクターとして貼り付けるホスト型 MCP URL も表示されます。

Vanoe Market Intelligence API を、MCP 対応のあらゆる AI アシスタント（Claude Desktop、Claude Code、Cursor など）が直接呼び出せるツールとして提供します。銘柄コードごとの複合スコア（0～100）、トレンド段階分析（現在の分析とバックテストに安全な週次履歴）、ポイント＆フィギュアのシグナル、セクターの騰落状況、マクロのリスクレジーム、SEC のインサイダー取引情報および 8-K 提出書類、マクロ経済カレンダー、利用状況を取得できます。

これは認証付きの薄いクライアントであり、無料枠ではありません。すべてのツール呼び出しは、REST API を直接呼び出す場合と同様に、ユーザー自身の API キーを使って、プランに応じた実際の従量課金で行われます。無料のキー（月 1,000 クレジット、カード不要）はこちらから取得できます：https://api.vanoe.ai/signup?src=mcp-readme

情報提供のみを目的としています。投資助言ではありません。https://api.vanoe.ai/terms をご覧ください。

ホスト型エンドポイント（インストール不要）

URL を指定して利用するクライアント（Claude.ai のカスタムコネクター、ChatGPT、ホスト型エージェントプラットフォームなど）向けに、API 自体が MCP のストリーミング可能な HTTP トランスポートを通じて同じツールを提供します。

• Authorization: Bearer <your key> を指定する https://api.vanoe.ai/mcp、または
• ヘッダーを送信できないクライアント向けの https://api.vanoe.ai/mcp/k/<your key> （登録後にキーのページにこの URL が表示されます。パスワードと同様に取り扱ってください）。

ステートレスで、JSON 形式の応答を返し、REST API と同様に従量課金されます。サーバーを自分のマシン上で実行したい場合は、以下のパッケージを使用してください。

Claude Desktop：ワンクリックでインストール

vanoe-market-intelligence.mcpb をダウンロードし、Claude Desktop（macOS または Windows）で開いてください。API キーを一度入力すると、安全に保存され、uv ランタイムを使ってサーバーがインストールされます。バンドルのソースは mcpb/ にあります。npx @anthropic-ai/mcpb pack mcpb vanoe-market-intelligence.mcpb で再ビルドできます。

インストール

uv を使う場合、インストール手順は不要です。uvx が必要に応じてパッケージを取得し、実行します。

uvx vanoe-intelligence-mcp

または、pipx install vanoe-intelligence-mcp か pip install vanoe-intelligence-mcp で永続的にインストールできます。これにより、vanoe-intelligence-mcp コマンドが PATH に追加されます。

MCP クライアントを設定する

環境変数 VANOE_API_KEY を設定します。VANOE_API_BASE_URL は省略可能で、省略した場合は https://api.vanoe.ai が使用されます。

Claude Desktop（claude_desktop_config.json）およびほとんどのクライアント：

{
  "mcpServers": {
    "vanoe": {
      "command": "uvx",
      "args": ["vanoe-intelligence-mcp"],
      "env": { "VANOE_API_KEY": "sk_live_your_key_here" }
    }
  }
}

Claude Code：

claude mcp add vanoe -e VANOE_API_KEY=sk_live_your_key_here -- uvx vanoe-intelligence-mcp

その後、「NVDA の評価はどうなっていますか？その理由は？」、「AAPL、MSFT、AMD はどの段階ですか？」、「現在のマクロレジームはリスクオンですか？」などとアシスタントに尋ねてください。以下のツールが呼び出されます。

ツール

ツール	API 呼び出し	クレジット
get_verdict(ticker)	GET /v1/verdict/{ticker}	5
get_stage(tickers)	GET /v1/signals/stage	ティッカーごとに1
get_stage_history(ticker, weeks)	GET /v1/signals/stage/history	5
get_pnf(tickers)	GET /v1/signals/pnf	ティッカーごとに1
get_sector_breadth()	GET /v1/sector-breadth	1
get_macro()	GET /v1/macro	1
get_filings(ticker)	GET /v1/filings/{ticker}	1
get_short_pressure(tickers)	GET /v1/signals/short-pressure	ティッカーごとに1
get_calendar()	GET /v1/calendar	1
get_usage()	GET /v1/usage	0

ツールは例外を発生させません。キーの不足、ネットワークエラー、クォータ超過、 不明なティッカーなど、どのような失敗でも、API 独自のメッセージを含む {"error": {"code", "message", "http_status"}} が返されるため、アシスタントは呼び出しをクラッシュさせずに 何が起きたかを説明できます。

Webhook の管理機能は意図的に公開していません。これはアカウント管理にあたり、 会話の途中で行うものではないためです。管理には REST API を使用してください。

開発

git clone https://github.com/vanoe-ai/vanoe-intelligence-mcp.git
cd vanoe-intelligence-mcp
python -m venv .venv && . .venv/bin/activate     # Windows: .venv\Scripts\activate
pip install -e '.[test]'
pytest tests
VANOE_API_BASE_URL=http://localhost:8000 VANOE_API_KEY=sk_live_… vanoe-intelligence-mcp

ソースコードは https://github.com/vanoe-ai/vanoe-intelligence-mcp にあります。問題の報告や プルリクエストを歓迎します。API サーバーもローカルで実行する場合は、この MCP サーバーを API サーバー自身の requirements.txt とは別の仮想環境にインストールしてください。 mcp SDK は、API の FastAPI のバージョン指定で許容されるものより新しい starlette を取得するため、同じ環境を共有すると API サーバーで Router.__init__() got an unexpected keyword argument 'on_startup' が発生し、 動作しなくなります。エンドユーザーがこの問題に遭遇することはありません（MCP サーバーは アシスタントと同じマシン上で実行されます）。

tests/manual_e2e_smoke.py は、実際のキーを使って接続可能な API に対し、実際のサーバーを サブプロセスとして stdio 経由で実行します。このテストは pytest には含まれていません。

MCP Python SDK は v2 です。サーバークラスは mcp.server.mcpserver.MCPServer です（古いチュートリアルでは、異なるインポートパスの FastMCP が紹介されています）。

リリース

python -m build
twine upload dist/*

まず pyproject.toml の version を更新してください。古い変数名の INTEL_API_KEY と INTEL_API_BASE_URL も、互換性のため引き続き使用できます。