Caisy MCP by usefulapi
Run read-only GraphQL queries and list documents and media assets in Caisy.
我该使用它吗
质量与安全性
发现（2）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domain在 caisy_run_query 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"caisy": {
"url": "https://caisy.usefulapi.io/mcp"
}
}
}远程端点
https://caisy.usefulapi.io/mcpstreamable-http它能做什么
工具清单
工具（4）
🟢caisy_run_query(query, variables)
Run one read-only GraphQL query against this project's Caisy external API. Use it for any field, filter (where), sort, nested connection or localized value. Mutations and subscriptions are refused. Caisy: POST https://cloud.caisy.io/api/e/v4/<projectId>/graphql with header x-caisy-apikey.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 20000,
"description": "A GraphQL query, e.g. { allPage(first: 5) { edges { node { id slug } } } }."
},
"variables": {
"description": "Optional GraphQL variables as a JSON object.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢caisy_list_queries
List the top-level read fields of this project's Caisy schema: one all<Blueprint> list query per non-unique blueprint, one single-entry query per unique blueprint, and the asset query. Call it first to learn the blueprint API ids.
输入模式
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢caisy_list_documents(blueprint, first, after)
List document ids of one blueprint with Relay pagination (all<Blueprint>(first, after)). Returns ids only: call caisy_run_query for the fields you need. Unique blueprints have no list query: use caisy_run_query with the blueprint's single-entry field.
输入模式
{
"type": "object",
"properties": {
"blueprint": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$",
"description": "The blueprint API id, e.g. Page (from caisy_list_queries)."
},
"first": {
"description": "Documents per page (1–100, default set by Caisy).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"after": {
"description": "Cursor: pass pageInfo.endCursor from the previous page to get the next page.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"blueprint"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢caisy_list_assets(first, after)
List media assets (title and source URL) of this project, with Relay pagination. Use the cursor from pageInfo.endCursor to read further.
输入模式
{
"type": "object",
"properties": {
"first": {
"description": "Documents per page (1–100, default set by Caisy).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"after": {
"description": "Cursor: pass pageInfo.endCursor from the previous page to get the next page.",
"type": "string",
"maxLength": 2000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社区
证据