AI导哈

Skema MCP服务器

Skema MCP服务器是Skema CMS的官方Model Context Protocol服务器，用于连接Claude Desktop、Cursor、Windsurf等兼容MCP协议的客户端与Skema数据。

  • by skemacms
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 skemacms/mcp-server

使用说明

Skema MCP Server

Serveur MCP (Model Context Protocol) officiel pour Skema CMS.
Connectez Claude Desktop, Cursor, Windsurf ou tout client MCP compatible à vos données Skema.

Installation

npm install -g @skemacms/mcp-server

Configuration

Claude Desktop

Ajoutez dans votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "skema-cms": {
      "command": "skema-mcp",
      "env": {
        "SKEMA_API_KEY": "pk_live_votre_cle_api",
      }
    }
  }
}

Windsurf / Cursor

Ajoutez dans vos paramètres MCP :

{
  "skema-cms": {
    "command": "npx",
    "args": ["-y", "@skemacms/mcp-server"],
    "env": {
      "SKEMA_API_KEY": "pk_live_votre_cle_api",
    }
  }
}

Variables d'environnement

Variable Description Requis
SKEMA_API_KEY Clé API Skema (format pk_live_xxx) Oui

Outils disponibles (11 outils)

Lecture

Outil Description
get_collections Liste toutes les collections accessibles
get_collection Récupère le schéma d'une collection (champs, types, relations)
get_collection_items Liste les items avec pagination, tri, filtres et populate
get_collection_item Récupère un item par son ID avec ses relations
search_collection_items Recherche textuelle dans une collection
count_collection_items Compte les items avec filtres optionnels

Écriture

Outil Description
create_collection_item Crée un nouvel item
update_collection_item Met à jour un item existant (merge partiel)
delete_collection_item Supprime un item
batch_create_items Crée plusieurs items en une seule requête
batch_update_items Met à jour plusieurs items en une seule requête

Exemples d'utilisation

Lister les collections

Quelles collections sont disponibles dans mon CMS ?

Récupérer des items avec relations

Liste les 10 derniers articles avec leurs auteurs et catégories

Créer un item

Crée un nouvel article avec le titre "Mon article" et le statut "draft"

Recherche

Recherche les produits contenant "smartphone" dans le titre

Opérations en masse

Mets à jour le statut de tous les articles de la catégorie "news" en "published"

API HTTP (alternative)

Vous pouvez aussi utiliser l'API MCP directement via HTTP :

Endpoint : POST https://api.skemacms.com/mcp

Headers :

  • Authorization: Bearer <API_KEY>
  • Content-Type: application/json

Exemple cURL

curl -X POST https://api.skemacms.com/mcp \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_collection_items",
      "arguments": {
        "collection": "articles",
        "page": 1,
        "perPage": 10,
        "populate": "author,category"
      }
    }
  }'

Exemple Python

import requests

API_KEY = "pk_live_xxx"
MCP_URL = "https://api.skemacms.com/mcp"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(MCP_URL, headers=headers, json={
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get_collection_items",
        "arguments": {"collection": "articles", "populate": "author"}
    }
})
print(response.json())

Méthodes JSON-RPC

Méthode Description
initialize Initialise la connexion MCP
tools/list Liste tous les outils disponibles
tools/call Exécute un outil avec ses arguments

Permissions

Les outils disponibles dépendent des permissions de votre clé API :

Permission Outils autorisés
read get_*, search_*, count_*
create create_*, batch_create_*
update update_*, batch_update_*
delete delete_*

Développement local

git clone https://github.com/skemacms/mcp-server.git
cd mcp-server
npm install
npm run dev

Liens utiles

Licence

MIT - Skema CMS

相关 MCP