OVS MCP
This server lets an MCP client interact with a connected Official Vegan Shop account: check login, search the live catalog, and preview/confirm cart changes without exposing credentials or personal data.
connect_ovs: Verify the OVS connection; if needed, provide a secure local login link where the user enters credentials outside MCP.
search_products: Search the live OVS catalog by query, with pagination (
page,limit) and structured product details (ID, name, price, availability, URL, etc.).get_cart: Read the connected account's cart without returning customer, email, or address data.
add_to_cart: Add one or more units (max 50) of a product ID; requires a confirmation token and does not mutate the cart without prior preview/confirmation.
remove_from_cart: Remove one or more units of a product ID, also preview/confirm based and fingerprint-guarded against cart changes.
Cart mutations are previewed first and confirmed with a token; the server refuses ambiguous writes and returns structured partial-modification errors if verification fails.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OVS MCP Cherche du seitan disponible et montre-moi les cinq meilleurs résultats."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
OVS MCP
Serveur Model Context Protocol non officiel pour Official Vegan Shop. Ajoutez ce dépôt à Codex, Claude Code ou tout client MCP compatible, connectez votre compte OVS, puis recherchez des produits et préparez votre panier en langage naturel.
Projet indépendant, sans affiliation avec Official Vegan Shop.
Installation dans un client MCP
Prérequis : Node.js 22.12 ou plus récent.
Utilisez directement le dépôt GitHub, sans clone local :
{
"mcpServers": {
"ovs": {
"command": "npx",
"args": [
"-y",
"--package=github:ncleton/ovs-mcp",
"ovs-mcp"
]
}
}
}Cette configuration utilise le transport MCP stdio, commun aux clients de bureau. Redémarrez le client après l’ajout.
Related MCP server: Amazon MCP Server
Connexion
Demandez simplement :
Connecte mon compte Official Vegan Shop.
Le client appelle connect_ovs et affiche un lien de connexion local sécurisé. Saisissez vos identifiants sur cette page, puis revenez dans le client.
Vous n’avez pas encore de compte ? Cette même page propose le lien officiel de création de compte OVS.
Le mot de passe ne passe jamais dans la conversation ni dans le protocole MCP.
Le mot de passe n’est jamais enregistré.
Seuls les cookies nécessaires à la session sont conservés localement dans un fichier privé (
0600).Les outils ne renvoient ni profil client, ni email, ni adresse.
Exemples de demandes :
Cherche du seitan disponible et montre-moi les cinq meilleurs résultats.
Ajoute deux unités du premier produit au panier.
Montre-moi le panier OVS.
Toute modification du panier est prévisualisée et exige une confirmation liée à l’état exact du panier.
La recherche retourne id, productAttributeId et
productCustomizationId. Ces trois identifiants désignent ensemble la ligne
exacte ; le serveur refuse une mutation qui omet la variante ou la
personnalisation au lieu de supposer silencieusement la valeur 0.
Outils MCP
Outil | Fonction |
| Vérifie la connexion ou fournit le lien de connexion sécurisé |
| Recherche le catalogue OVS en direct |
| Lit le panier sans exposer les données du compte |
| Prévisualise, confirme et ajoute un produit |
| Prévisualise, confirme et retire un produit |
CLI
npx -y --package=github:ncleton/ovs-mcp ovs connect
npx -y --package=github:ncleton/ovs-mcp ovs search "seitan"
npx -y --package=github:ncleton/ovs-mcp ovs cart
npx -y --package=github:ncleton/ovs-mcp ovs add 17170 --attribute 0 --customization 0La commande add ou remove sans --confirm ne modifie rien : elle retourne
l’état attendu et une empreinte du panier. Pour appliquer ensuite exactement
cette prévisualisation, répétez la commande avec --confirm et
--cart-fingerprint <empreinte-retournée>. Si le panier a changé entre les
deux appels, la commande échoue et exige une nouvelle prévisualisation.
Une écriture dont la relecture devient impossible ou incohérente échoue avec
un objet structuré contenant cart_may_be_partially_modified=true, les
identifiants exacts de la cible, requested_units et applied_units.
applied_units vaut null tant qu’une relecture indépendante ne permet pas de
prouver le nombre réellement appliqué. Le connecteur ne répète jamais
automatiquement une écriture ambiguë.
Développement
npm ci
npm run verifyLe serveur HTTP optionnel n’écoute que sur la boucle locale :
npm run compile
node dist/index.js --transport httpSécurité et confidentialité
Le dépôt ne contient aucun compte, identifiant, cookie, panier ou fixture personnelle. Le contrôle de confidentialité analyse aussi le paquet distribuable avant publication. Consultez SECURITY.md pour signaler un problème sans publier de secret.
Les fixtures de test sont exclusivement synthétiques, à l’exception de
l’enveloppe vide publique et expurgée du mini-panier. Le contrat observé et les
limites de chaque preuve sont documentés dans
skills/ovs-mcp/references/observed-contract.md.
Licence MIT.
Available Tools
5 toolsadd_to_cartAdd OVS product to cartADestructive
Preview, confirm, and add one or more units of an OVS product ID.
Inputs: productId (required), quantity, confirmationToken. Returns: data
connect_ovsConnect Official Vegan ShopA
Check the OVS connection. When needed, returns a private local login URL that the client must present to the user. Credentials never pass through MCP.
Inputs: no named parameters. Returns: data
get_cartGet OVS cartARead-onlyIdempotent
Read the connected account cart without returning customer or address data.
Inputs: no named parameters. Returns: data
remove_from_cartRemove OVS product from cartADestructive
Preview, confirm, and remove one or more units of an OVS product ID.
Inputs: productId (required), quantity, confirmationToken. Returns: data
search_productsSearch OVS productsARead-onlyIdempotent
Search the live Official Vegan Shop catalog.
Inputs: query (required), page, limit. Returns: page, limit, query, total, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct concern: connection, product search, cart read, add, and remove. There is no overlap or ambiguity between tools.
All tool names follow a consistent verb_noun pattern with underscores: connect_ovs, search_products, get_cart, add_to_cart, remove_from_cart. Naming is uniform and predictable.
The set of 5 tools is well-scoped for a shopping cart and catalog server. Each tool serves a clear function without unnecessary bloat or missing essentials.
The surface covers connection, catalog search, and cart CRUD operations (read, add, remove). Minor gaps include lack of an explicit update quantity tool, but add/remove can adjust quantities, so overall coverage is solid.
Maintenance
Related MCP Connectors
Functional mushroom shop (PL/EN): live catalog search, recommendations and checkout links.
Live product search for AI agents across Shopify merchants and major retailers.
AI shopping gateway for product search, inventory, carts, and merchant-hosted checkout.
AI-powered commerce API for luxury skincare shopping. Enables AI agents to search products, browse collections, manage shopping carts, and generate checkout URLs for the Regenique Elegance Shopify store.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search products, manage shopping carts, place orders, and retrieve order history from Amazon and Target accounts.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Amazon services through AI assistants, allowing users to search products, manage their cart, view order history, and place orders using natural language.10 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables product discovery, session-scoped carts, and confirmation-gated checkout through natural language, with deterministic routing and safety features.ISC
- FlicenseNot gradedqualityCmaintenanceEnables users to interact with an e-commerce shopping assistant using natural language to search products, check prices and ratings, compare items, and get personalized recommendations.-