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端点根据端点和请求上下文具有不同的访问行为。