stock-mcp

Yahoo Finance から株価情報を取得する MCP サーバーです。

セットアップ

npm install

開発起動

npm run dev

ビルド

npm run build

MCP クライアント設定

このサーバーは stdio transport で起動します。MCP クライアントには、ビルド後の build/index.js を node で実行するように設定します。

事前にビルドしてください。

npm install
npm run build

Codex

~/.codex/config.toml またはプロジェクトの .codex/config.toml に設定します。

[mcp_servers.StockPrice]
command = "node"
args = ["/path/to/stock-mcp/build/index.js"]

CLI で追加する場合:

codex mcp add StockPrice -- node /path/to/stock-mcp/build/index.js

Claude Code

Claude Code の MCP 設定は JSON の mcpServers 形式です。プロジェクトで共有する場合は .mcp.json に設定します。

{
  "mcpServers": {
    "StockPrice": {
      "command": "node",
      "args": [
        "/path/to/stock-mcp/build/index.js"
      ]
    }
  }
}

CLI で追加する場合:

claude mcp add --transport stdio StockPrice -- node /path/to/stock-mcp/build/index.js

開発用設定

開発中に TypeScript のまま起動したい場合は、各クライアントで npm --prefix ... run dev を実行するように設定します。

Codex:

[mcp_servers.StockPrice]
command = "npm"
args = [
  "--prefix",
  "/path/to/stock-mcp",
  "run",
  "dev",
]

Claude Code:

{
  "mcpServers": {
    "StockPrice": {
      "command": "npm",
      "args": [
        "--prefix",
        "/path/to/stock-mcp",
        "run",
        "dev"
      ]
    }
  }
}

設定後、MCP クライアントを再起動すると StockPrice ツールを利用できます。

MCP ツール

• サーバー名: StockPrice
• StockPrice: symbol に銘柄コードを指定して株価情報を取得します。

入力

パラメータ	型	必須	説明
symbol	string	Yes	銘柄コード。米国株は AAPL、日本株は 7203.T のように取引所サフィックスを付けます。

例:

{
  "symbol": "AAPL"
}

出力

yahoo-finance2 の quote() の結果を、加工せず JSON 文字列にしてテキストコンテンツで返します。フィールドの内容は yahoo-finance2 および Yahoo Finance 側の仕様に従うため、詳細は下記を参照してください。

• yahoo-finance2 (npm)
• API ドキュメント

エラー時も yahoo-finance2 が投げた内容がそのまま MCP のツールエラーとして返ります。