股票数据协议服务器

一个为科伦坡证券交易所提供结构化的实时和历史数据访问的模型上下文协议服务器,使AI代理和应用程序能够无缝查询、分析和集成斯里兰卡市场数据。

  • by Yazhodha
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 Yazhodha/CSE-MCP-Server

使用说明

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的客户端)

安装

  1. 克隆存储库:
git clone <repository-url>
cd SharesMCP
  1. 构建项目:
dotnet build
  1. 运行服务器:
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代理能够无缝访问科伦坡证券交易所的数据。