项目简介

Midday AI MCP 服务器是一个基于 Model Context Protocol (MCP) 实现的应用后端,它包装了 Midday AI 平台的各项功能,如发票管理、时间追踪、文件协调、存储、财务概览等。通过将这些功能暴露为 LLM 可调用的“工具”,它使得 AI 应用程序能够以标准化的方式访问和操作 Midday AI 中的业务数据和功能。

主要功能点

Midday AI MCP 服务器提供以下主要领域的上下文信息和操作能力:

  • 财务管理: 访问和管理交易、银行账户,获取收入、利润、支出、资金使用率等财务指标。
  • 发票管理: 列出、检索、删除发票,查询发票支付状态,获取发票汇总信息。
  • 时间追踪: 列出时间追踪条目和项目,创建、更新、检索、删除时间追踪项目和条目。
  • 客户管理: 列出、创建、检索、更新、删除客户信息。
  • 文档管理: 列出、检索、删除存储在 Midday AI 中的文档。
  • 标签管理: 列出、创建、检索、更新、删除用于分类各种实体的标签。
  • 用户与团队管理: 检索当前用户信息,更新用户资料,列出、检索、更新团队信息,列出团队成员。
  • 全局搜索: 跨不同类型的数据(发票、文档、客户、交易等)进行搜索。

安装步骤

此 MCP 服务器作为 Midday TypeScript SDK 包的一部分发布。可以通过 npm 或 npx 直接运行:

  1. 确保您已安装 Node.js v20 或更高版本。

  2. 使用以下命令启动 MCP 服务器:

    npx -y --package @midday-ai/sdk -- mcp start --api-token <您的 Midday API Token>

    请将 '<您的 Midday API Token>' 替换为您实际的 Midday API Token。'-y' 参数会自动确认安装 '@midday-ai/sdk' 包。

服务器配置

LLM 客户端需要配置 MCP 服务器的启动命令才能与之通信。以下是一个示例 JSON 配置结构(请勿直接复制此代码块,它仅为说明目的):

{
  "mcpServers": {
    "Midday": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "@midday-ai/sdk",
        "--",
        "mcp",
        "start",
        "--api-token",
        "..." // 在此处填写您的 Midday API Token
      ]
    }
  }
}
  • '"Midday"': 您为该服务器定义的友好名称。
  • '"command"': LLM 客户端用于启动服务器的执行程序(例如,'npx')。
  • '"args"': 传递给 'command' 的参数数组,用于指定要运行的包、命令以及必要的配置(例如,'--api-token' 需要您的 Midday API Token)。

LLM 客户端会使用这些信息来启动服务器进程并建立通信。

基本使用方法

配置完成后,LLM 客户端(如支持 MCP 的 AI 助手)即可通过该服务器访问您的 Midday AI 数据并执行操作。LLM 可以:

  • 查询最近的交易记录。
  • 查找某个客户的信息。
  • 列出所有逾期发票。
  • 记录一个新的时间追踪条目。
  • 获取某段时间内的收入概览。
  • 搜索相关文档。

LLM 会根据其内部逻辑和用户的指令,自动调用服务器暴露的相应工具来完成任务。

信息

分类

商业系统