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"
}社群
證據