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，因此能够浏览 Registry 的应用可以找到它。

claude.ai 网页版或手机应用？

目前还不支持。网页版和移动应用只能连接托管在互联网上的服务，而这个服务运行在你的电脑上。你可以使用 uvx cse-mcp --http，通过 HTTPS URL 自行托管（请参阅下文“开发”部分），然后将该 URL 添加为自定义连接器。

---

🧰 AI 可以用它做什么

工具	功能
get_market_overview	市场开市/休市状态、ASPI 和 S&P SL20、今日成交额/成交量/交易笔数
get_top_movers	今日涨幅最大、跌幅最大或最活跃的股票
list_stocks	按名称/代码搜索所有上市股票，并按成交额、涨跌幅、市值等排序
get_stock	单只股票的完整资料：价格、区间（1 周至历史最高）、市值、外资持股、贝塔值
get_price_history	价格历史：今日（15 分钟线）、1w、1m、3m 或 1y
get_trades_by_price	今日各价格档位的成交量，以及 VWAP
get_sector_indices	所有 S&P/CSE 行业指数，按表现从优到劣排列
get_index_history	ASPI / S&P SL20 / 任意行业指数的历史走势
get_market_daily_summary	外资与本地买入情况（外资净流入）、市场市盈率、市净率、股息率
get_announcements	股息、财务报表（PDF 链接）、通告、违规通知等

所有工具均为只读，无法下单交易或更改任何内容。

可以这样提问：

• “给我一份今天的市场综述。”
• “今天外资是净买入还是净卖出？”
• “列出最活跃的 10 只股票，以及它们所属的行业。”
• “过去一年 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 工具（每个函数对应一个工具，易于阅读）
• tests/：使用模拟 API 响应进行离线测试，另有一个可选的在线测试

端点参考：社区编写的 CSE API 文档。

---

⚠️ 须知

• 非官方。 与 Colombo Stock Exchange 无关联，也未获其认可。cse.lk API 是公开的，但没有文档说明，因此可能随时变更。如果某个工具无法使用，请提交问题。
• 保护隐私。 不会收集任何信息。请求会直接从你的计算机发送到 cse.lk。请参阅 PRIVACY.md。
• 请适度使用。 响应会缓存 30 秒，以免向 cse.lk 发送过多请求。请保持这一设置。
• 非财务建议。 数据可能有延迟或错误，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"]。

欢迎提出想法、报告 Bug 和提交 PR。请参阅 CONTRIBUTING.md。

📄 许可证

MIT：使用、分叉并基于它构建。