Maesn MCP

Maesn-Mcp服务器

Maesn的官方MCP（模型上下文协议）服务器使用 Nx公司，设计用于连接Maesn的统一后端API。此服务器使工具能够通过结构化、经过身份验证的请求检索客户、发票、账单和账户等会计数据。

______________________________________________________________________

🚀 特性

• ⚡ 快速、可扩展的Nx+TypeScript设置
• 🧰 通过MCP与Maesn的统一API预集成
• 🧪 即用型工具：客户、发票、账单、账户

______________________________________________________________________

📦 安装

git clone https://github.com/YOUR_ORG/maesn-mcp.git
cd maesn-mcp
npm install

⚙️ 设置

先决条件

在本地运行Maesn MCP服务器之前，请确保您具备以下条件：

• 🔐 一个Maesn API密钥\

您可以通过 Maesn开发者门户.

• 🧱 Node.js（v16或更高版本）\

我们建议使用Node.js v20+以获得最佳兼容性。从这里下载 .

• 🧰 Nx CLI（可选但有用）\

Nx用于管理和运行工作区。全局安装以便于使用：

  npm install -g nx

MCP配置（如克劳德集成）

将Maesn MCP服务器连接到MCP兼容环境（如 克劳德桌面版)，下载并安装Claude，然后按照以下步骤操作：

1. 在您的计算机上找到配置文件。对于Claude Desktop，这通常是：

• 视窗: %APPDATA%/Claude/claude_desktop_configuration.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_configuration.json
• Linux: ~/.config/Claude/claude_desktop_configuration.json

1. 将以下条目添加到 mcpServers 文件的一部分：

{
  "mcpServers": {
    "maesn-mcp": {
      "command": "node",
      "args": [
        "/apps/maesn-mcp/dist/main.js"
      ]
    }
  }
}

🔁 将\替换为您构建的MCP服务器的完整本地路径。

环境变量配置

创建一个 .env 使用您的凭据在项目根目录中创建文件：

设置：

1. 创建您的 .env 从示例中可以看出：

cp .env.example .env

1. 填写您的凭据：

API_KEY=your_maesn_api_key
ACCOUNT_KEY=your_maesn_account_key

⚠️ Claude Desktop有一个已知的错误 env 变量在 claude_desktop_config.json 注射不可靠，这就是为什么 .env 使用该方法。如果您使用的是正确注入环境变量的不同MCP兼容客户端，则可以改为以本机方式传递它们。

🛠 在本地运行

克隆项目后，安装依赖项：

npm install

然后启动开发服务器：

npx nx serve maesn-mcp

可用资源

MCP服务器仍在开发中，但统一API中支持的大多数资源已通过我们的MCP完全可用。 以下是当前支持的资源列表：

• 账户
• 异步任务
• 账单
• 预订建议
• 联系人
• 客户
• 维度
• 开支
• 货物收据
• 发票
• 物品
• 日记条目
• 期刊
• 优惠
• 支付
• 付款条件
• 项目
• 采购订单
• 销售订单
• 供应商
• 税率
• 单位
• 供应商信用

⚠️ 注意：文件支持尚不可用。将逐步增加额外的资源和工具。

📬 联系我们

有疑问、需要帮助或想探索Maesn能为您做些什么？我们是来帮忙的。

🌐 了解更多

• 访问我们的网站： maesn.com
• 探索统一的API： Maesn API文档

🤝 联系我们

• 📧 电子邮件： contact@maesn.com
• 💬 预订演示： maesn.com/contact