项目简介
Midday AI MCP 服务器是一个基于 Model Context Protocol (MCP) 实现的应用后端,它包装了 Midday AI 平台的各项功能,如发票管理、时间追踪、文件协调、存储、财务概览等。通过将这些功能暴露为 LLM 可调用的“工具”,它使得 AI 应用程序能够以标准化的方式访问和操作 Midday AI 中的业务数据和功能。
主要功能点
Midday AI MCP 服务器提供以下主要领域的上下文信息和操作能力:
- 财务管理: 访问和管理交易、银行账户,获取收入、利润、支出、资金使用率等财务指标。
- 发票管理: 列出、检索、删除发票,查询发票支付状态,获取发票汇总信息。
- 时间追踪: 列出时间追踪条目和项目,创建、更新、检索、删除时间追踪项目和条目。
- 客户管理: 列出、创建、检索、更新、删除客户信息。
- 文档管理: 列出、检索、删除存储在 Midday AI 中的文档。
- 标签管理: 列出、创建、检索、更新、删除用于分类各种实体的标签。
- 用户与团队管理: 检索当前用户信息,更新用户资料,列出、检索、更新团队信息,列出团队成员。
- 全局搜索: 跨不同类型的数据(发票、文档、客户、交易等)进行搜索。
安装步骤
此 MCP 服务器作为 Midday TypeScript SDK 包的一部分发布。可以通过 npm 或 npx 直接运行:
-
确保您已安装 Node.js v20 或更高版本。
-
使用以下命令启动 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 会根据其内部逻辑和用户的指令,自动调用服务器暴露的相应工具来完成任务。
信息
分类
商业系统