内容
<p align="center">
<img src="assets/logo-text-light-1024.png" alt="CeylonCharts" width="100%">
</p>
# CeylonCharts MCP 服务器
科伦坡证券交易所（CSE）市场数据 — 符号、OHLC价格历史、财务报表、公司公告、市场/行业指数和宏观经济指标 — 可用如下:
- 一个 **REST API** (`https://mcp.ceyloncharts.com/api`)
- 一个 **MCP 服务器** (`https://mcp.ceyloncharts.com/mcp/`) 用于人工智能代理和助手，例如 Claude
本仓库记录了如何连接到托管服务器以及如何调用其端点。它不包含服务器的源代码。
## 目录
- [快速入门](docs/getting-started.md) — 从 Claude.ai、Claude Desktop 或纯 HTTP 连接
- [MCP 工具参考](docs/mcp-tools.md) — 通过 MCP 公开的八种工具
- [REST API 参考](docs/rest-api.md) — 端点、参数、响应格式
- [身份验证](docs/authentication.md) — API 密钥和 OAuth
- [速率限制](docs/rate-limits.md) — 计划层级和限制
- [示例](examples/) — 可运行的 curl、Python 和 Node 代码段
## 可用的 MCP 工具
| 工具 | 描述 |
|------|-------------|
| `get_symbols` | 列出/搜索 CSE 上市公司 |
| `get_ohlc_data` | 每日/每周/每月 OHLC 价格历史 |
| `get_financials` | 季报财务报表数据 |
| `get_announcements` | 公司公告/备案 |
| `get_macro_series` | 列出可用的宏观经济系列 |
| `get_macro_data` | 宏观经济指标数据 |
| `get_indices` | 列出 CSE 市场/行业指数（ASPI，S&P SL20，行业子指数） |
| `get_index_data` | 市场/行业指数的历史数据 |
有关完整的输入/输出格式，请参见 [docs/mcp-tools.md](docs/mcp-tools.md)。
## 快速示例
```bash
curl -H "X-User-Id: <your-user-id>" \
-H "X-Api-Key: <your-api-key>" \
https://mcp.ceyloncharts.com/api/v1/symbols
```
## 获取访问权限
API 密钥需经请求而非自助注册 — 请参阅 [docs/authentication.md](docs/authentication.md) 了解如何请求一个。
## 许可证
- [examples/](examples/) 中的代码示例根据 [MIT](LICENSE) 许可。
- [docs/](docs/) 中的文档根据 [CC BY 4.0](LICENSE-DOCS) 许可。
