freispace MCP Server

freispace MCP 服务器

一个模型上下文协议 (MCP) 服务器，为排程软件 freispace 提供分析和洞察。该服务器使 AI 助手（例如 Copilot、Gemini）能够查询 freispace 中的数据，例如项目统计信息和规划相关信息。

概述

freispace MCP 服务器将任何具备工具调用能力的大语言模型连接到 freispace，以查询分析数据。

使用 freispace 的媒体团队可以利用 MCP 服务器，通过公司范围的 AI（例如 Copilot）将规划数据提供给整个公司，而无需用户登录 freispace 甚至了解 freispace，同时也能帮助后期制作团队在排程和规划时做出数据驱动的决策。

我们的 MCP 服务器始终尊重用户权限，确保大语言模型只能按用户级别访问数据，从而保障数据安全。

示例查询可能包括“过去谁与 X 共事过”或“我还剩多少天假期？”

先决条件

1. freispace 旗舰版 账户
2. 有效的 freispace MCP API 密钥
   • 在 beta 期间，请联系您的 freispace 支持团队以获取 MCP API 密钥

可用工具

所有查找均基于名称。支持部分名称匹配；将使用第一个匹配项。

get_current_user

获取调用用户的身份信息：姓名、电子邮件和关联的员工记录。无需参数。用于将“我”/“我的”解析为员工姓名。

“我当前以什么身份登录？”

get_staffs

列出员工，包含姓名、职位和员工编号。

• status（可选）：active（默认）、inactive、all

“列出所有员工” · “公司里的开发人员有哪些？”

find_resources

在一次调用中按名称搜索房间/工作室（套房）、设备/许可证（资源）和员工，并按类型分组。

• search（可选）：名称或部分名称；省略则列出全部
• staff（可选）：internal 或 external
• site（可选）：仅限匹配站点的套房
• status（可选）：active（默认）、inactive、all

“查找 Sammy” · “列出外部自由职业者”

get_availability

检查员工、套房或资源在某个日期窗口内（默认 14 天，最长 92 天）的空闲时间，同时考虑预订、公共假期以及员工缺勤/工作时间。

• type（必填）：staff、resource、suite 或 site
• search、staff、site、status（可选）：实体选择，同 find_resources
• from、to、days、weeks（可选）：日期窗口
• duration + duration_unit（可选）：所需的空闲时长（minutes、hours 或 days）

“下周二有工作室空闲 3 小时吗？” · “未来两周内谁有整整两天的空闲时间？”

get_my_schedule

获取调用用户在某个日期窗口内（默认：未来 7 天）的自身预订。

• from、to、days、weeks（可选）：日期窗口

“我这周的日程安排是什么？”

get_my_tasks

获取分配给调用用户的任务，包含截止日期、优先级和参考信息。

• include_done（可选）：同时包含已完成的任务

“我的待处理任务有哪些？”

get_open_tasks

获取团队的所有待处理任务，包含负责人。

• reference（可选）：project、booking 或 user

“哪些项目任务仍未完成？”

get_staff_projects

列出某位员工被预订参与的项目，包含日期范围和时长。

• staff_name（必填）

“Karl 被预订了哪些项目？”

get_staff_collaborators

根据共同的预订记录，显示某位员工曾与谁共事过。

• staff_name（必填）

“Alexander 曾与谁共事过？”

get_staff_next_holiday

获取某位员工即将到来的下一个假期（开始日期、结束日期、时长、备注）。

• staff_name（可选；省略则查询调用用户）

“我的下一个假期是什么时候？” · “Hendrikje 什么时候休假？”

get_staff_holiday_quota

获取某位员工某一年的假期配额：总天数、已用天数和剩余天数。

• staff_name（可选；省略则查询调用用户）
• year（可选；默认为当前年份）

“我还剩多少天年假？”

get_project_stats

获取单个项目的预订统计信息：过去与未来的预订，并按状态细分。

• project_name（必填）

“显示 Alpha 项目的预订统计信息”

get_project_team

列出参与过某个项目的员工，以及他们在该项目上的预订数量。

• project_name（必填）

“谁参与了网站改版项目？”

get_project_tasks

获取单个项目的任务状态：该项目及其预订上的所有任务，包含未完成/已完成/逾期的摘要。

• project_name（必填）

“纪录片项目有未完成的任务吗？”

get_invoices

列出带有筛选条件和按币种合计的发票；支持分页。状态分类：draft、open、overdue、paid、partially-paid、canceled、locked。

• search（可选）：匹配编号、订单号、主题、收件人地址
• status、number、date_min/date_max、due_date_min/due_date_max、sum_min/sum_max、outstanding_min/outstanding_max、sort、order、page、per_page（可选）

“哪些发票已逾期？” · “Acme 的未结发票”

get_offers

列出带有筛选条件和按币种净额合计的报价单；支持分页。状态分类：draft、locked、open、accepted、declined。

• search、status、number、date_min/date_max、sum_min/sum_max、sort、order、page、per_page（可选）

“显示今年已拒绝的报价单”

get_orders

列出订单（工单），并内联显示其关联的报价单和发票；支持分页。

• search（可选）：匹配订单号和名称
• status、number、date_min/date_max、sort、order、page、per_page（可选）

“订单 2026-014 的报价和开票情况如何？”

search_docs

搜索 freispace 文档并返回最相关的摘录。

• query（必填）
• limit（可选）：最大摘录数，默认 5

“如何在 freispace 中设置班次规划？”

错误处理

错误将以简短、可操作的提示信息返回给调用模型（例如 Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.）。诊断信息记录到 stderr；stdout 仅承载 MCP 协议。

⚠️ 测试版通知

我们的 freispace MCP 服务器目前处于测试阶段。在此期间，所有功能均免费。我们感谢您的反馈和耐心，我们将持续改进平台。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

支持

如需支持和提问：

• 文档：freispace 文档
• 问题：GitHub Issues
• 联系：freispace 支持