使用说明

CSE MCP 服务器

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

特点/特性

公司搜索通过模糊匹配按名称或代码搜索CSE（加拿大证券交易所）上市公司的股票
实时股票数据获取任何CSE（加拿大证券交易所）股票代码的当前价格、变化量及百分比变化
模糊匹配即使名称有拼写错误或只是部分名称，也能找到公司
308家公司所有在CSE（证券交易所，此处为假设缩写，具体需根据上下文确定）上市公司的完整数据库

使用MCP客户端进行安装

Claude Desktop（桌面版Claude）/ Claude Code（代码版Claude）

使用Claude CLI（推荐）

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

手动配置

或者，添加到您的Claude配置中（~/Library/Application Support/Claude/claude_desktop_config.json （在Mac上）：

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

其他MCP客户端

使用以下命令配置：

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

可用工具

1. 搜索公司

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

输入：

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": "Top 3 matches using fuzzy search"
}

2. 获取股票数据

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

输入：

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

从源代码构建

# Clone the repository
git clone https://github.com/Shaveen12/cse-mcp.git
cd cse-mcp

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode (watches for changes)
npm run dev

# Test locally with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

项目结构

cse-mcp/
├── src/
│   └── index.ts        # Main server implementation
├── bin/
│   └── cse-mcp.js      # CLI entry point
├── dist/               # Compiled JavaScript (generated)
├── cse_companies.csv   # Company database
├── package.json
├── tsconfig.json
└── README.md

API速率限制

计算机科学与工程（CSE）API有以下考虑因素：

无需认证
建议采用合理的速率限制
每个请求的超时时间设置为10秒

数据源

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

做出贡献

欢迎贡献！请随时提交拉取请求。

为仓库创建分支（或“克隆仓库”）
创建你的特性分支（git checkout -b feature/AmazingFeature)
提交您的更改（git commit -m 'Add some AmazingFeature')
推送至分支（git push origin feature/AmazingFeature）
提交一个拉取请求

许可证

此项目采用ISC许可证授权 - 详情请参阅package.json文件。

免责声明

此工具仅供信息参考之用。股市数据可能存在延迟。在做出投资决策前，请务必通过官方渠道核实数据。

支持

对于问题、疑问或建议，请在（相关平台）上提交一个议题 GitHub。

致谢

科伦坡证券交易所提供数据API
模型上下文协议针对MCP SDK（MCP软件开发工具包）