米达兹-MCP服务器

Name: 米达兹-MCP服务器
Author: LerianStudio

作者：LerianStudio4 星标更新：2025-11-17

安装使用来源：spider==github.com

项目介绍

Lerian MCP Server

让您的AI助手即时访问Lerian文档和API！此插件连接Claude、ChatGPT和其他AI助手到Lerian金融系统，因此您可以在对话中直接获得集成、API和故障排除的帮助。

🔄 迁移通知： 此包之前称为@lerianstudio/midaz-mcp-server。为了向后兼容，两个包名都可以使用，但我们建议迁移到新的@lerianstudio/lerian-mcp-server包名。

⚡ 5分钟设置

步骤1： 选择您的AI助手
步骤2： 复制以下配置
步骤3： 重启您的AI应用
步骤4： 开始询问有关Lerian的问题！

🖥️ Claude桌面版

位置： ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或%APPDATA%\Claude\claude_desktop_config.json（Windows）

{
  "mcpServers": {
    "lerian": {
      "command": "npx",
      "args": ["@lerianstudio/lerian-mcp-server@latest"]
    }
  }
}

<details> <summary>🔄 <strong>向后兼容性</strong>（点击展开）</summary>

{
  "mcpServers": {
    "midaz": {
      "command": "npx",
      "args": ["@lerianstudio/midaz-mcp-server@latest"]
    }
  }
}

旧包名仍然可以工作但已被弃用，请迁移到@lerianstudio/lerian-m-服务器。

</details>

🖥️ Claude代码（命令行）

# 安装一次（新包）
npm install -g @lerianstudio/lerian-mcp-server

# 添加到Claude代码
claude mcp add lerian "lerian-mcp-server"

<details> <summary>🔄 <strong>从旧包迁移</strong>（点击展开）</summary>

# 移除旧包
npm uninstall -g @lerianstudio/midaz-mcp-server

# 安装新包
npm install -g @lerianstudio/lerian-mcp-server

# 更新Claude代码
claude mcp remove midaz
claude mcp add lerian "lerian-mcp-server"

</details>

💬 ChatGPT桌面版

添加到您的ChatGPT桌面版MCP配置文件：

{
  "mcpServers": {
    "lerian": {
      "command": "npx",
      "args": ["@lerianstudio/lerian-mcp-server@latest"]
    }
  }
}

⚡ Cursor IDE

位置： 文件 → 首选项 → Cursor设置 → MCP → 添加新的全局MCP服务器

{
  "mcp.servers": {
    "lerian": {
      "command": "npm",
      "args": ["exec", "@lerianstudio/lerian-mcp-server@latest"]
    }
  }
}

🌊 Windsurf IDE

位置： 文件 → 首选项 → Windsurf设置 → 管理插件 → 查看原始配置

{
  8 "mcpServers": {
    "lerian": {
      "command": "npm",
      "args": ["exec", "@lerianstudio/lerian-mcp-server@latest"]
    }
  }
}

🔄 Continue IDE

位置： ~/.continue/config.yaml（MacOS/Linux）或%USERPROFILE%\.continue\config.yaml（Windows）

{
  "mcpServers": {
    "lerian": {
      "command": "npm",
      "args": ["exec", "@lerianstudio/lerian-mcp-server@latest"]
    }
  }
}

✨ 您将获得

一旦连接，您可以向您的AI助手提问：

📚 “解释Lerian账户是如何工作的”
🔧 “展示如何创建一笔交易”
🏗️ “上架和交易API之间的区别是什么？”
💡 “生成用于创建组织的Go代码”
🐛 “帮助我调试这个Lerian集成错误”
📊 “Lerian使用哪些数据模型？”

🧙‍♂️ 增强的工作流程提示

全新！ 交互式向导和故障排除助手：

基本工作流程

🎯 create-transaction-wizard - 分步创建交易
🔍 debug-my-balance - 带上下文的余额故障排除
🏗️ setup-my-org - 组织设置向导
📊 explain-my-data - 智能数据分析和见解
🚀 help-me-start - 快速入门指南
🔧 help-with-api - API特定指导
📚 help-me-learn - 个性化学习路径

高级智能（全新！）

📄 check-file-balances - 多格式文件分析（CSV/TXT/JSON），带智能UUID提取
💰 check-external-balance - 根据资产（美元、欧元、比特币等）检查外部账户余额
🔍 discover-lerian-hierarchy - 探索完整的组织→账簿→资产→账户链
🛠️ show-all-tools - 所有工具、操作和参数的完整目录

增强功能：

文件格式支持： 自动检测CSV、TXT和JSON文件
智能UUID提取： 对TXT文件进行智能解析，可选LLM确认
外部余额监控： 检查系统级别的资产余额和流动性
商业智能： 资产分布分析和国库管理见解

使用方法： “使用check-file-balances分析我的accounts.txt文件” 或 “使用check-external-balance查看美元流动性”

🆘 需要帮助？

不起作用？

在添加配置后重启您的AI应用
检查文件位置 - 确保您编辑了正确的配置文件
尝试基本测试：问您的AI“你能访问Lerian文档吗？”

仍然有问题？

Claude桌面用户：验证MCP是否在您的Claude桌面版本中启用
所有用户：确保您的计算机上安装了Node.js
获取支持：GitHub问题

🔄 迁移帮助

从Midaz MCP Server迁移？

@lerianstudio/midaz-mcp-server 和 @lerianstudio/lerian-mcp-server 工作方式完全相同
所有环境变量都与MIDAZ_*和LERIAN_*前缀一起工作
配置文件在.midaz和.lerian目录中均有效
命令midaz-mcp-server和lerian-mcp-server是等效的

推荐迁移步骤：

将您的MCP配置更新为使用@lerianstudio/lerian-mcp-server
重启您的AI助手
可选地将环境变量从MIDAZ_*更新为LERIAN_*
可选地将配置文件从.midaz/移动到.lerian/目录

🔒 安全且可靠

✅ 只读访问（不能修改您的数据）
✅ 基本使用不需要API密钥
✅ 所有数据都留在您的计算机上
✅ 开源并可审核

⚙️ 配置

环境变量

通过这些可选环境变量配置服务器行为：

日志配置：

ERROR_LOGGING=true - 启用错误日志记录到文件（默认：禁用）
PERFORMANCE_TRACKING=true - 启用性能跟踪日志（默认：禁用）
AUDIT_LOGGING=true - 启用安全审计日志（默认：禁用）

注意： 所有日志默认都是禁用的，以防止日志文件增长。仅在需要调试或监控时启用。

示例Claude桌面配置带日志：

{
  "mcpServers": {
    "lerian": {
      "command": "npx",
      "args": ["@lerianstudio/lerian-mcp-server@latest"],
      "env": {
        "ERROR_LOGGING": "true",
        "PERFORMANCE_TRACKING": "true"
      }
    }
  }
}

日志管理：

日志文件存储在./logs/目录中
当文件超过10MB时自动轮换
7天后清理旧日志
手动清理：删除logs/目录

🛠️ 开发与贡献

开发人员快速入门

# 设置并本地运行
make setup                    # 初始项目设置
make dev                      # 启动开发服务器

# 提交前（与CI/CD完全匹配）
make ci-all                   # 在本地运行完整的CI管道

可用命令

make ci-all - 在本地运行完整的CI/CD管道（提交前推荐）
make docs-serve - 生成并本地提供文档
make typecheck - TypeScript类型检查
make audit - 安全漏洞扫描

文档

📊 系统架构图 - 视觉系统文档