Skip to main content
Glama

🤖 Claude-Code MCP Runner (Package Edition)

Le Pilote Automatique pour vos Agents IA, désormais modulaire et réutilisable.

Architecture du projet

đź‘‹ C'est quoi ?

Il s'agit d'une véritable télécommande universelle pour Claude-Code et d'autres outils CLI similaires. Ce projet est désormais structuré comme une bibliothèque (package) moderne, permettant non seulement de lancer un serveur MCP autonome, mais aussi d'intégrer les capacités de pilotage d'agents directement dans vos propres applications Node.js.

C'est la passerelle ultime pour transformer Claude Code en une flotte d'agents spécialisés, pilotables par API ou par MCP.

Related MCP server: cc-agent

✨ Ce que ça fait

  • 🔌 ContrĂ´le Total : Lancez des missions complexes via MCP ou directement via le code.

  • 🏗️ Architecture Pro : BasĂ© sur des services (AgentManager, ClaudeRunner, PromptManager) pour une stabilitĂ© maximale.

  • 🛠️ CapacitĂ©s Étendues : L'agent pilotĂ© peut utiliser VOS outils (Base de donnĂ©es, Scrapers, etc.).

  • 🤖 Multi-Agents : CrĂ©ez, configurez et gĂ©rez des personnalitĂ©s d'agents isolĂ©es (Prompts & Settings dĂ©diĂ©s).

  • 📦 PrĂŞt pour l'IntĂ©gration : Importable comme un module NPM dans vos autres projets.


🚀 Commencer (Guide Facile)

1. Installation

# Installe les dépendances
pnpm install

# Build le projet (Génère les types TS et le code JS)
pnpm run build

2. Configuration MCP

Pour que l'agent puisse voir vos autres serveurs MCP, copiez le fichier d'exemple :

cp .mcp.json.example .mcp.json

3. Lancer le Serveur Standalone

Le serveur peut être lancé via le CLI dédié :

# Lancement standard
pnpm start

# Ou via le binaire directement
node dist/bin/cli.js

📦 Utilisation comme Bibliothèque

Vous pouvez désormais importer le moteur du runner dans vos propres scripts :

import { createServer, AgentManager, ClaudeRunner } from 'claude-code-runner';

// 1. Gérer les agents programmatiquement
const manager = new AgentManager();
await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude-3-5-sonnet');

// 2. Lancer une exécution sans passer par MCP
const runner = new ClaudeRunner();
const result = await runner.runAgent({
  agentName: 'expert-seo',
  prompt: 'Analyse le site example.com',
  autoResume: true,
});

console.log(result.result);

🛠️ Configuration MCP (Client)

Pour connecter ce runner Ă  un client (Cursor, Claude Desktop, etc.), pointez vers le nouvel entrypoint CLI :

{
  "mcpServers": {
    "claude-runner": {
      "command": "node",
      "args": ["/CHEMIN_VERS_PROJET/dist/bin/cli.js"]
    }
  }
}

đź“‚ Structure du Projet

  • src/services/ : Le cĹ“ur du système (Logique mĂ©tier isolĂ©e en services).

  • src/tools/ : Les outils MCP qui appellent les services.

  • src/bin/cli.ts : Le point d'entrĂ©e exĂ©cutable pour le terminal.

  • src/server.ts : La dĂ©finition du serveur FastMCP.

  • src/index.ts : Les exports publics (API de la bibliothèque).

  • .claude/ : Stockage des agents (Prompts .md et Settings .json).


Aperçu du Terminal

Projet propulsé par DeaMoN888 - 2026

Available Tools

7 tools
create_agentB

Crée un nouvel agent (Prompt + Config) compatible avec ce runner

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesNom de l'agent (ex: agent_finance). Sera utilisé pour les noms de fichiers.
modelNoModèle à utiliser. Supporte tous les modèles compatibles avec Claude Code (Anthropic, OpenAI, DeepSeek, Glm, Minimax, etc.). Ex: claude-sonnet-4-5, gpt-4, deepseek-chatclaude-sonnet-4-5
promptYesLe prompt système (instructions) de l'agent.
copyEnvFromNoChemin vers un settings.json existant pour copier les variables d'environnement (ex: .claude/settingsM.json)

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Aucune annotation n'est fournie, donc la description porte toute la charge de transparence. Elle ne précise pas les effets secondaires (création de fichiers, écrasement potentiel), les prérequis ou le comportement en cas d'erreur.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Une phrase concise et frontale qui résume l'action, sans verbiage inutile. Tous les mots sont utiles.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Pour un outil de création avec 4 paramètres, 2 obligatoires, sans schéma de sortie ni annotations, la description ne couvre pas suffisamment le comportement attendu (retour, effets, contraintes).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

La couverture du schéma est de 100 %, chaque paramètre ayant une description. La description de l'outil n'ajoute pas de sens supplémentaire au-delà du schéma, ce qui correspond à la note de base de 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

La description indique clairement que l'outil crée un agent avec prompt et configuration, ce qui le distingue des outils frères comme 'create_prompt' (création de prompt uniquement) ou 'update_agent_config' (modification de configuration).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

La description n'offre pas de directives explicites sur quand utiliser cet outil par rapport à ses alternatives ni prérequis. L'utilisation est implicite via le nom et le contexte des outils frères.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_promptA

Crée ou écrase un fichier prompt Markdown (Persona)

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesNom du fichier prompt (sans extension). Ex: 'analyse_financiere'
contentYesContenu Markdown du prompt

TDQS

A3.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description explicitly mentions the overwrite behavior ('écrase'), which is a destructive action. Since no annotations are provided, this disclosure is important for an agent to understand the potential side effect.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that is front-loaded with the action and resource. It avoids unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description lacks context about when to use the tool, success indications, error conditions, or how it differs from edit_prompt. For a tool with no output schema and no annotations, this is insufficient for an agent to fully understand its behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema provides full descriptions for both parameters (name and content), achieving 100% coverage. The tool description adds no additional parameter-specific meaning beyond the schema, so a score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool creates or overwrites a prompt Markdown file (Persona), using the verb 'crée ou écrase' and specifying the resource. This distinguishes it from siblings like create_agent or edit_prompt.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, such as edit_prompt. The description does not mention prerequisites or situations where overwriting is appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_agentA

Supprime définitivement un agent (Prompt et Config)

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesNom de l'agent Ă  supprimer (ex: agent_finance)

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Discloses that deletion is permanent, a key behavioral trait. No annotations exist, so description carries full burden. Could mention cascading effects or required permissions, but is adequate for a simple delete.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence that is front-loaded and contains no filler. Every word is necessary and clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given low complexity (one parameter, no output schema), the description is sufficient to understand the tool's function and input. Missing return value details are not an issue here.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the parameter is well-documented in the schema. The description adds no new information about the parameter beyond its existence.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool permanently deletes an agent, including its Prompt and Config. Verb and resource are specific and distinct from sibling tools like create_agent or list_agents.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when or when not to use this tool versus alternatives. However, the context of sibling tools implies its use for deletion only.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

edit_promptC

Modifie un prompt existant en remplaçant un bloc de texte spécifique

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesNom du fichier prompt Ă  modifier (ex: 'agent_news')
searchYesLe texte exact Ă  rechercher et remplacer
replaceYesLe nouveau texte de remplacement

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided; description only says 'replaces a specific text block' but does not disclose side effects, whether it modifies the file in place, or if the operation is reversible. Insufficient for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence is concise but lacks detail. Could include usage notes or examples without being verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Description is too brief for a tool with 3 required parameters. It doesn't specify behavior like exact match replacement, case sensitivity, or return value. Incomplete for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with clear parameter descriptions. The tool description adds no additional meaning beyond the schema, meeting baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the verb 'modifie' (modify) and resource 'prompt existant' with specific action 'remplaçant un bloc de texte spécifique'. It distinguishes from sibling 'create_prompt' which is for creating new prompts.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool vs alternatives. Lacks context about prerequisites or scenarios where editing is preferred over creating a new prompt.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_agentsA

Liste tous les agents disponibles. Option 'details=true' pour voir la config complète.

ParametersJSON Schema
NameRequiredDescriptionDefault
detailsNoSi true, affiche les détails complets (modèle, config) de chaque agent.

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavior. It indicates a read-only list operation without side effects, but does not explicitly confirm non-destructiveness or mention any response details.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences with no redundancy. Every word adds value. The structure is front-loaded with the main purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple list tool with one optional parameter and no output schema, the description is complete enough. It could mention that it returns agent names, but the core functionality is clear.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with a clear description for the 'details' parameter. The description adds a brief mention of the option, but does not significantly enhance the schema's meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool lists all agents, with an option for full config. The verb 'list' and resource 'agents' are explicit. It distinguishes from siblings like create_agent or run_agent.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by listing agents, but does not explicitly state when to use this tool versus alternatives. No when-not or prerequisites are mentioned, though it's the only list tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_agentB

Exécute une commande sur l'agent Claude configuré via CLI

ParametersJSON Schema
NameRequiredDescriptionDefault
promptYesLe prompt Ă  envoyer Ă  l'agent
agentNameNoNom de l'agent (pour logging/monitoring et persistance)
sessionIdNoID de session pour continuer une conversation (manuel)
autoResumeNoSi true (et agentName fourni), reprend automatiquement la dernière conversation de cet agent

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must fully disclose behavior. It only states it executes a command, omitting side effects (e.g., conversation persistence, logging, rate limits, authentication requirements).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence (10 words) that front-loads the core purpose. However, it could be slightly more descriptive without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 4 parameters, no output schema, and no annotations, the description lacks completeness. It does not mention return values, how to resume sessions, or error handling, leaving the agent uncertain.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with clear parameter descriptions. The prompt and agentName descriptions add context beyond naming (e.g., 'pour logging/monitoring et persistance'). The baseline is 3 due to high coverage, but the parameter descriptions are helpful.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Exécute une commande sur l'agent Claude configuré via CLI' clearly states it runs a command on a Claude agent, distinguishing it from sibling tools that manage agents/prompts. However, 'commande' is slightly vague; 'prompt' would be more precise.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives (e.g., create_agent first) or prerequisites. The description does not indicate that the agent must be configured or that this is the primary execution tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

update_agent_configB

Modifie la configuration technique d'un agent (Modèle, Serveurs MCP, Variables d'environnement)

ParametersJSON Schema
NameRequiredDescriptionDefault
envNoVariables d'environnement supplémentaires à définir ou écraser (ex: { 'API_KEY': '123' })
nameYesNom de l'agent Ă  modifier
modelNoNouveau modèle à utiliser. Supporte tous les modèles compatibles avec Claude Code (Anthropic, OpenAI, DeepSeek, Glm, Minimax, etc.). Ex: claude-sonnet-4-5, gpt-4, deepseek-chat
mcpServersNoListe complète des serveurs MCP à activer (remplace la liste existante). Ex: ['postgresql', 'news']

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavioral traits. It only says 'modifies configuration' without explaining mutation details, idempotency, error behavior, or prerequisites beyond the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single, front-loaded sentence that efficiently conveys the purpose without extraneous words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 4 parameters, no output schema, and no annotations, the description lacks completeness. Missing return value, error scenarios, and update semantics (partial vs full replacement).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description adds minimal value beyond listing the parameter categories already evident from the schema names.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool modifies an agent's technical configuration, listing the specific aspects (Model, MCP Servers, Environment Variables). It distinguishes from siblings like create_agent and delete_agent.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like create_agent or run_agent. Sibling tools are not referenced, and no context for decision-making is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 7 tool updatesv1.0.0
    • First observedcreate_agent
    • First observedcreate_prompt
    • First observeddelete_agent
    • First observededit_prompt
    • First observedlist_agents
    • First observedrun_agent
    • First observedupdate_agent_config

TDQS

A3.7/5.0
Disambiguation5/5

Each tool targets a distinct operation: agent creation vs prompt creation, agent deletion, prompt editing, listing agents, running agents, and config updating. The descriptions clearly differentiate them, so no ambiguity.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_agent, edit_prompt, run_agent), making them predictable and easy to understand.

Tool Count5/5

With 7 tools, the server covers the essential operations for managing and running agents without being overly narrow or bloated. The number fits the scope well.

Completeness4/5

The tool set covers create, read, update, delete for agents and prompts, plus execution. A minor gap is the lack of a dedicated get_agent tool (though list_agents with details=true partly covers it), but overall the surface is solid.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/DeamonDev888/-SIMPLE-CLAUDE-API-RUNNER-'

If you have feedback or need assistance with the MCP directory API, please join our Discord server