使用说明
CSE MCP服务器
科伦坡证券交易所模型上下文协议服务器
模型上下文协议(MCP)服务器,为科伦坡证券交易所(CSE)提供结构化、实时和历史数据访问,使人工智能代理和应用程序能够无缝查询、分析和集成斯里兰卡市场数据。
概述
CSE MCP服务器通过模型上下文协议公开CSE市场数据,弥合了科伦坡证券交易所和人工智能应用程序之间的差距。这使Claude AI和其他兼容MCP的代理能够访问所有CSE上市证券的实时报价、公司简介、交易数据、财务报表和历史价格。
主要特点
实时市场数据
- 股票报价:当前价格、变化、数量和市值
- 公司简介:详细的公司信息、行业分类和联系方式
- 交易数据:日内交易、交易量和价格变动
- 市场概述:指数、涨幅最大/跌幅最大的股票、最活跃的股票
历史数据
- 价格历史:具有灵活时间段和间隔的OHLCV数据
- 财务报表:季度和年度报告(如有)
- 公司行为:股息、拆分和公告
CSE特定功能
- 多股票支持:处理具有多种股份类型(有表决权/无表决权)的公司
- 符号灵活性:支持多种符号格式(JKH、JKH.CM、JKH.N0000)
- 斯里兰卡市场背景:行业分类、交易时间和市场惯例
建筑
基于清洁建筑原则:
- 领域层:核心CSE实体和业务规则
- 应用层:用例和数据转换
- 基础设施层:CSE API集成和数据持久性
- 表示层:MCP工具和协议实施
技术栈
- .NET 10:现代高性能运行时
- MCP-SDK:官方。NET实现模型上下文协议
- CSE官方API:与科伦坡证券交易所直接整合
- HTTP/SSE传输:服务器发送实时更新事件
快速开始
先决条件
- .NET 10 SDK
- Claude Desktop(或任何兼容MCP的客户端)
安装
- 克隆存储库:
git clone <repository-url>
cd SharesMCP
- 构建项目:
dotnet build
- 运行服务器:
dotnet run --project SharesMCP
服务器将于启动 http://localhost:5248 (默认)。
配置Claude桌面
添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):
{
"mcpServers": {
"cse": {
"url": "http://localhost:5248/sse"
}
}
}
重新启动Claude Desktop以连接到CSE MCP服务器。
可用的MCP工具
市场数据工具
GetStockQuote
获取任何CSE上市证券的当前股票报价。
参数:
symbol(字符串):股票代码(例如,“JKH”、“JKH.CM”或“JKH.N0000”)
例子:
User: What's the current price of John Keells Holdings?
Claude: [Uses GetStockQuote with symbol "JKH"]
GetCompanyProfile
获取详细的公司信息和简介。
参数:
symbol(string):股票代码
GetDayTrades
获取今天的交易活动和个人交易。
参数:
symbol(string):股票代码
CSE股票代码
服务器支持所有CSE上市证券的多种符号格式:
- 短视频:
JKH,COMB,SAMP - .CM格式:
JKH.CM,COMB.CM,SAMP.CM - CSE格式:
JKH.N0000,COMB.N0000,SAMP.N0000
受欢迎的CSE股票
- 秸杆颗粒机 -John Keells控股有限公司
- 梳子 -锡兰商业银行
- 样本 -桑帕斯银行
- 拨号 -对话框Axiata PLC
- 家庭基站 -哈顿国家银行
- 国家开发银行 -NDB银行PLC
用例
对于AI代理
- 查询实时CSE市场数据
- 分析斯里兰卡公司基本面
- 跟踪投资组合绩效
- 生成投资见解
面向开发者
- 构建支持CSE的应用程序
- 整合斯里兰卡市场数据
- 创建交易算法
- 开发财务仪表板
给投资者
- 通过Claude AI访问CSE数据
- 获取即时公司信息
- 跟踪实时价格变动
- 分析市场趋势
路线图
阶段0:行走骨架✅
- 带三个工具的基本MCP服务器
- CSE API官方集成
- 符号格式转换
- 实时数据访问
第一阶段:基础(进行中)
- 干净架构重构
- CSE实体的域模型
- 增强的缓存层
- 历史价格数据
第二阶段:扩展数据访问
- 财务报表整合
- 公司公告
- 市场指数和行业
- 高级过滤和搜索
第三阶段:分析能力
- 技术指标
- 基本指标
- 比较分析
- 市场筛选工具
第四阶段:生产特点
- 利率限制和弹性
- 全面的错误处理
- 性能优化
- 监控和日志记录
贡献
欢迎投稿!该项目旨在为MCP生态系统提供全面的CSE数据访问。
数据源
所有市场数据来源于:
- CSE官方API: https://www.cse.lk/api/
- CSE网站: https://www.cse.lk
许可证
[待定]
免责声明
此MCP服务器仅提供市场数据访问。它不提供投资建议或意见。在做出投资决策之前,始终进行自己的研究并咨询合格的财务顾问。
为模型上下文协议生态系统构建
使AI代理能够无缝访问科伦坡证券交易所的数据。
