OpenLedger MCP Server

概述

OpenLedger MCP 服务器是符合 Model Context Protocol (MCP) 规范的 API 实现，它允许 AI 模型（如 Claude）以结构化方式与 OpenLedger 财务数据交互。

安装与启动

选项 1：本地安装

# 克隆仓库
git clone https://github.com/yourusername/Open-Ledger-MCP-Server.git
cd Open-Ledger-MCP-Server

# 安装依赖
bun install

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件添加您的配置

# 启动服务器
bun start

选项 2：使用 Docker

# 克隆仓库并进入目录
git clone https://github.com/yourusername/Open-Ledger-MCP-Server.git
cd Open-Ledger-MCP-Server

# 使用 Docker Compose 构建并运行
docker-compose up --build

# 或使用提供的脚本
./docker-run.sh

与 Claude 集成

将以下配置添加到您的 Claude 设置中：

{
  "mcpServers": {
    "openledger": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

可用资源

• openledger://transactions - 财务交易管理
• openledger://companies - 公司信息管理
• openledger://categories - 交易类别管理
• openledger://reports - 财务报告生成

开发命令

# 开发模式（热重载）
bun dev

# 运行测试
bun test

# 生产构建
bun run build

更多详细信息请参阅 MCP_USAGE.md 文档。