Lithic

🚀 石 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：列出指定類型的資源。

環境變量

支持的資源類型

• 卡
• 賬戶
• 財務賬戶
• 交易
• 事件
• 餘額
• 糾紛
• 外部銀行賬戶
• 報告
• 回調
• 賬戶持有者

開發

對於開發，你可以使用觀察模式：

npm run dev

這將自動重建並在你更改源代碼時重新啟動服務器。