石 lithic MCP 服务器（TypeScript）

一个使用 TypeScript 实现的 Lithic API 的模型上下文协议 (MCP) 服务器，提供对 Lithic 银行和卡服务的只读访问。

功能

• 使用 MCP SDK 的现代 TypeScript 实现
• 对所有 Lithic API 端点提供只读访问
• 类型安全工具用于访问 Lithic 资源
• Docker 支持
• 改进的错误处理和验证

快速开始

使用 Docker（推荐）

1. 构建 Docker 镜像：

npm run docker:build

2. 运行服务器：

LITHIC_API_KEY=your_key_here npm run docker:run

手动设置

1. 安装依赖项：

npm install

2. 构建 TypeScript 代码：

npm run build

3. 启动服务器：

LITHIC_API_KEY=your_key_here npm start

MCP 配置

将以下内容添加到你的 .cursor/mcp.json 或 Claude 桌面配置中：

{
  "lithic": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-e", "LITHIC_API_KEY",
      "-e", "LITHIC_API_BASE_URL",
      "mcp/lithic"
    ],
    "env": {
      "LITHIC_API_KEY": "your_lithic_api_key_here",
      "LITHIC_API_BASE_URL": "https://api.lithic.com/v1"
    }
  }
}

可用工具

此 MCP 服务器提供以下工具：

• get_resource：按 ID/令牌获取特定的 Lithic 资源
• list_resources：列出指定类型的资源

环境变量

• LITHIC_API_KEY - 你的 Lithic API 密钥（必需）
• LITHIC_API_BASE_URL - Lithic API 基础 URL（默认：https://sandbox.lithic.com/v1）

支持的资源类型

• 卡
• 账户
• 财务账户
• 交易
• 事件
• 余额
• 纠纷
• 外部银行账户
• 报告
• 回调
• 账户持有者

开发

对于开发，你可以使用观察模式：

npm run dev

这将自动重建并在你更改源代码时重新启动服务器。