AI导哈

创意服务管理工具

用于管理和查询创意服务、个人资料及客户请求的结构化工具。

  • by RA1NM4KER
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 RA1NM4KER/fineapp-mcp

使用说明

fineapp mcp

MCP服务器，用于通过结构化工具公开FineApp创意、过滤器、配置文件、会话产品和客户端请求。

特性

  • 列出FineApp的创意
  • 支持分页创意搜索
  • 支持对创意列表和搜索进行类别过滤
  • 使用本地筛选按角色和位置查找创意
  • 获取可用的创意专业和地点
  • 通过slug获取创意档案
  • 通过创意ID获取创意会话类型和套餐
  • 提供一个方便的工具，在一次通话中提供完整的创意细节
  • 列出来自FineApp的客户端请求
  • 按类别、位置和状态查找客户端请求
  • 使用Zod验证工具输入和外部API响应
  • 使用FineApp API实时数据

你能做什么

一旦连接到像Codex这样的MCP客户端，您可以问以下问题：

  • 在斯泰伦博斯找到摄像师，给我看看他们的包。
  • 为斯泰伦博斯的情侣拍摄选择最好的FineApp创意，并使用他们的个人资料和软件包来证明选择的合理性。
  • FineApp提供哪些服务？
  • FineApp上有哪些可用的位置？
  • FineApp上当前打开了哪些客户端请求？
  • 查找斯泰伦博斯的摄影请求。
  • 如果你能用一句话说出大多数请求是关于什么的。

工具

创意作品

list_creatives

列出创意。

输入

  • page 可选数字，默认值 0
  • size 可选数字，默认值 8
  • category 可选字符串

示例输入

{
  "page": 0,
  "size": 8,
  "category": "photographer"
}

search_creatives

使用后端搜索搜索创意。

输入

  • search 必填字符串
  • page 可选数字，默认值 0
  • size 可选数字，默认值 8
  • category 可选字符串

示例输入

{
  "search": "videographer",
  "page": 0,
  "size": 8,
  "category": "videographer"
}

find_creatives

使用本地筛选列表数据，按可选角色和/或位置查找创意。

输入

  • role 可选字符串
  • location 可选字符串
  • category 可选字符串
  • page 可选数字，默认值 0
  • size 可选数字，默认值 50

示例输入

{
  "role": "videographer",
  "location": "Stellenbosch",
  "category": "videographer",
  "page": 0,
  "size": 50
}

get_creative_filters

获取可用的FineApp创意特色和地点。

输入

  • 无

示例输入

{}

配置文件和包

get_creative_profile

按作品集大小获取创意简介。

输入

  • slug 必填字符串

示例输入

{
  "slug": "chichi"
}

get_creative_session_types

按创意ID获取创意的会话类型和包。

输入

  • creativeId 所需数量

示例输入

{
  "creativeId": 7
}

get_creative_full_details

通过公文包slug在一次调用中获取创意配置文件和会话类型。

输入

  • slug 必填字符串

示例输入

{
  "slug": "chichi"
}

输出形状示例

{
  "profile": {},
  "sessionTypes": []
}

请求：

list_requests

列出来自FineApp的客户端请求。

输入

  • page 可选数字，默认值 0
  • size 可选数字，默认值 12
  • status 可选枚举： OPEN, IN_PROGRESS, ACCEPTED, COMPLETED, CANCELLED, EXPIRED

示例输入

{
  "page": 0,
  "size": 12,
  "status": "OPEN"
}

find_requests

按可选类别、位置和状态查找客户端请求。

输入

  • category 可选字符串
  • location 可选字符串
  • status 可选枚举： OPEN, IN_PROGRESS, ACCEPTED, COMPLETED, CANCELLED, EXPIRED
  • page 可选数字，默认值 0
  • size 可选数字，默认值 12

示例输入

{
  "category": "photography",
  "location": "Stellenbosch",
  "status": "OPEN",
  "page": 0,
  "size": 12
}

科技

  • TypeScript
  • Node.js
  • MCP TypeScript SDK
  • 黄道带
  • 更漂亮
  • Vitest
  • 瓶颈
  • p重试

在本地运行

npm install
npm run dev

Codex设置示例

codex mcp add fineapp -- npx tsx src/index.ts

然后从仓库启动Codex，并使用以下命令检查连接的MCP服务器：

/mcp

测试

运行测试：

npm run test

跑步覆盖率：

npm run test:coverage

该项目包括以下测试：

  • 端点URL构建器
  • FineApp API包装
  • 请求客户端行为
  • 创意数据助手
  • 请求数据助手

项目结构

src/
  data/      orchestration helpers
  lib/       request client and endpoint builders
  schemas/   zod schemas
  tools/     MCP tool registration by domain
  types/     shared TypeScript types

备注

  • 分页为0索引，因此第一页为 page=0.
  • 此服务器专为与Codex等MCP客户端一起使用本地stdio而设计。
  • 该项目使用实时FineApp API数据，并使用Zod验证外部响应。
  • 一些FineApp端点根据端点和请求上下文具有不同的访问行为。

相关 MCP