CSE MCP Server

这是一个提供科伦坡证券交易所（CSE）实时股市数据的模型上下文协议（MCP）服务器。该服务器使AI助手能够搜索公司并从斯里兰卡股市中获取当前股票价格。

功能

• 公司搜索：通过名称或代码模糊匹配搜索CSE上市的公司
• 实时股票数据：获取任何CSE股票代码的当前价格、变化及百分比变化
• 模糊匹配：即使有拼写错误或部分名称也能找到公司
• 308家公司：包含所有CSE上市公司的完整数据库

使用MCP客户端安装

Claude Desktop / Claude Code

使用Claude CLI（推荐）

claude mcp add cse-mcp -- npx cse-mcp

手动配置

或者，在您的Claude配置文件中添加（Mac系统路径：~/Library/Application Support/Claude/claude_desktop_config.json）：

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

其他MCP客户端

使用以下命令配置：

• 命令：npx
• 参数：["cse-mcp"]

可用工具

1. search_company

搜索在科伦坡证券交易所上市的公司。

输入：

• query（字符串）：要搜索的公司名称或代码

功能：

• 使用模糊搜索返回前3个匹配项
• 搜索符号和公司名称
• 处理拼写错误和部分匹配

示例：

{
  "query": "john keells"
}

响应：

{
  "query": "john keells",
  "count": 3,
  "companies": [
    {
      "id": 297,
      "symbol": "JKH.N0000",
      "name": "JOHN KEELLS HOLDINGS PLC"
    },
    {
      "id": 596,
      "symbol": "JKL.N0000",
      "name": "JOHN KEELLS HOTELS PLC"
    },
    {
      "id": 556,
      "symbol": "JKPL.N0000",
      "name": "JOHN KEELLS PLC"
    }
  ],
  "note": "使用模糊搜索的前3个匹配项"
}

2. get_stock_data

获取特定股票代码的实时股票价格数据。

输入：

• symbol（字符串）：确切的股票代码（例如，“JKH.N0000”）

功能：

• 验证公司数据库中的代码
• 从CSE API获取实时数据
• 返回以斯里兰卡卢比（Rs.）计价的价格

示例：

{
  "symbol": "JKH.N0000"
}

响应：

{
  "symbol": "JKH.N0000",
  "companyName": "JOHN KEELLS HOLDINGS PLC",
  "price": "Rs. 22.20",
  "change": "-0.10",
  "changePercentage": "-0.45%",
  "lastUpdated": "2024-12-17T10:30:00.000Z"
}

开发

先决条件

• Node.js 16 或更高版本
• npm 或 yarn

从源码构建

# 克隆仓库
git clone https://github.com/Shaveen12/cse-mcp.git
cd cse-mcp

# 安装依赖
npm install

# 构建TypeScript
npm run build

# 在开发模式下运行（监视更改）
npm run dev

# 使用MCP Inspector本地测试
npx @modelcontextprotocol/inspector node dist/index.js

项目结构

cse-mcp/
├── src/
│   └── index.ts        # 主服务器实现
├── bin/
│   └── cse-mcp.js      # CLI入口点
├── dist/               # 编译后的JavaScript（生成）
├── cse_companies.csv   # 公司数据库
├── package.json
├── tsconfig.json
└── README.md

API速率限制

CSE API有以下考虑事项：

• 不需要身份验证
• 推荐合理的速率限制
• 请求超时设置为10秒

数据来源

公司数据和实时价格来自科伦坡证券交易所。

贡献

欢迎贡献！请随意提交Pull Request。

1. 分叉仓库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 打开Pull Request

许可证

此项目根据ISC许可证发布 - 详情见package.json文件。

免责声明

此工具仅供信息参考。股市数据可能会延迟。在做出投资决策之前，请始终使用官方来源验证数据。

支持

对于问题、疑问或建议，请在GitHub上打开一个Issue。

致谢

• 科伦坡证券交易所 提供数据API
• 模型上下文协议 提供MCP SDK