CSE Market Data

cse-mcp

Claude（またはあらゆる AI）に、コロンボ証券取引所の最新データを提供します。
価格をチャットにコピー＆ペーストする必要はもうありません。

You:    How did banks do today vs the ASPI? Anything interesting from COMB?
Claude: *checks get_market_overview, get_sector_indices, get_stock, get_announcements*
        The ASPI closed +2.75% at 22,123. Banks did even better (+3.7%).
        COMB ended at LKR 225.25 (+4.3%) on 1.5M shares...

cse-mcp はMCPサーバーです。MCP は、AI アプリがツールを利用できるようにする標準の「プラグ」です。このサーバーは AI を cse.lk の公開データに接続し、最新の価格、指数、発表に基づいた回答を可能にします。

---

⚡ インストール（アプリを選択）

Claude Desktop：ワンクリックで、ほかにインストール不要

1. 最新リリースから cse-mcp-<version>.mcpb をダウンロードします。
2. ダブルクリックするか、Claude Desktop にドラッグして、Install をクリックします。
3. 「今日の CSE の状況は？」 と質問します 🎉

Claude Desktop が Python など必要なものをすべてセットアップします。

Claude Code

claude mcp add cse -- uvx cse-mcp

または、マーケットアナリストのスキルも追加されるプラグインとしてインストールできます。

/plugin install cse-mcp --marketplace lxnid/cse-mcp

Cursor、VS Code、Windsurf、Claude Desktop（手動）、その他の MCP アプリ

アプリの MCP 設定に以下を追加します。

{
  "mcpServers": {
    "cse": { "command": "uvx", "args": ["cse-mcp"] }
  }
}

uv（高速な Python パッケージマネージャー）が必要です（brew install uv を実行するか、Windows の場合はリンク先を参照してください）。Python 自体は自動的にダウンロードされます。

また、公式の MCP Registry に io.github.lxnid/cse-mcp として掲載されているため、レジストリを検索するアプリから見つけることができます。

ウェブ版またはスマートフォンの claude.ai で使えますか？

まだ使えません。ウェブアプリやモバイルアプリが接続できるのはインターネット上でホストされたサーバーのみですが、このサーバーはお使いのコンピューター上で動作します。HTTPS URL の背後で uvx cse-mcp --http を使ってご自身でホストし（下記の「開発」を参照）、その URL をカスタムコネクターとして追加できます。

---

🧰 このサーバーで AI ができること

ツール	内容
get_market_overview	市場の開場・閉場状況、ASPI と S&P SL20、当日の売買代金・出来高・取引件数
get_top_movers	当日の上昇率上位、下落率上位、または取引が最も活発な銘柄
list_stocks	上場銘柄を名前やティッカーで検索し、売買代金、変動率、時価総額などで並べ替え
get_stock	1 銘柄の詳細プロフィール：価格、期間別レンジ（1 週間から過去最高値まで）、時価総額、外国人保有比率、ベータ
get_price_history	価格履歴：当日（15 分足）、1 週間、1 か月、3 か月、または 1 年
get_trades_by_price	当日の価格帯別出来高と VWAP
get_sector_indices	S&P／CSE の全セクター指数を、好調なものから順に表示
get_index_history	ASPI／S&P SL20／任意のセクター指数の時系列データ
get_market_daily_summary	外国人と国内投資家の買い越し・売り越し（外国人の純資金流入）、市場の P/E、P/BV、配当利回り
get_announcements	配当、財務諸表（PDF リンク）、回覧、コンプライアンス違反通知など

すべてのツールは読み取り専用です。取引の発注や、何らかの変更はできません。

質問の例：

• 「今日の市場動向をまとめてください。」
• 「今日は外国人投資家が買い越しでしたか、それとも売り越しでしたか？」
• 「取引が最も活発な銘柄の上位 10 件と、それぞれのセクターを見せてください。」
• 「過去 1 年間の HNB の動きを Banks 指数と比べるとどうですか？」
• 「今日は新しい四半期決算が発表されましたか？プランテーション関連のものを要約してください。」
• 「今日は JKH の出来高の大半がどの価格帯で取引されましたか？」

💡 ティッカーは柔軟に指定できます：jkh、JKH、JKH.N0000 はいずれも使えます。議決権のない株式には X0000 を使います（例：JKH.X0000）。

---

🧠 仕組み

 Your AI ──MCP──▶ cse-mcp (on your computer) ──HTTPS──▶ www.cse.lk/api/*
                   │
                   └─ tidies the JSON: readable names, rounded numbers,
                      Sri Lanka time, 15-min bars, PDF links, 30s cache

• src/cse_mcp/client.py：cse.lk と通信します（タイムアウト、エラー、30 秒のキャッシュ）
• src/cse_mcp/server.py：MCP ツール（それぞれ 1 つの関数で、読みやすい構成です）
• tests/：API レスポンスを偽装したオフラインテストと、オプトイン方式のライブテスト

エンドポイントのリファレンス：コミュニティによる CSE API のドキュメント。

---

⚠️ 知っておくべきこと

• 非公式です。 Colombo Stock Exchange とは提携しておらず、承認も受けていません。cse.lk API は公開されていますが、ドキュメントがないため、予告なく変更される可能性があります。ツールが動作しなくなった場合は、issue を作成してください。
• プライバシーを尊重します。 情報を収集することはありません。リクエストはお使いのコンピューターから cse.lk に直接送信されます。PRIVACY.md をご覧ください。
• 節度を持って利用してください。 cse.lk に過剰なリクエストが送られないよう、レスポンスは 30 秒間キャッシュされます。この設定を維持してください。
• 金融アドバイスではありません。 データには遅延や誤りがある可能性があり、AI が数値を誤読することもあります。取引の前に必ず再確認してください。
• 価格の単位は LKR です。時刻は スリランカ時間（UTC+05:30） です。取引時間は月曜日から金曜日の 09:30～14:30 です。

---

🛠️ 開発

git clone https://github.com/lxnid/cse-mcp.git && cd cse-mcp
uv sync
uv run pytest                  # offline tests (fast, no internet)
uv run pytest -m live          # hit the real cse.lk API
uv run cse-mcp --http          # serve over HTTP at http://127.0.0.1:8000/mcp
uv run mcp dev src/cse_mcp/server.py   # poke the tools in the MCP Inspector (needs Node.js)

Claude Desktop でローカルコピーを実行するには、"command": "uv", "args": ["--directory", "/ABSOLUTE/PATH/TO/cse-mcp", "run", "cse-mcp"] を使用してください。

アイデア、バグ報告、PR を歓迎します。CONTRIBUTING.md をご覧ください。

📄 ライセンス

MIT：自由に使用、フォーク、拡張できます。