Compile plusieurs MCP servers et API REST en un point de terminaison d'outils unique et optimisé pour réduire la consommation de contexte et améliorer la précision des agents.
Aussi connu sous toolc-dev/toolc, @toolc/cli
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.1
- Dernier commit
- 15 sept. 2026
- Licence
- Apache-2.0
Qu'est-ce que toolc MCP ?
toolc est un serveur MCP. Compile plusieurs MCP servers et API REST en un point de terminaison d'outils unique et optimisé pour réduire la consommation de contexte et améliorer la précision des agents.
Résumé généré à partir du README du projet
À propos du MCP server toolc
toolc agit comme un compilateur d'optimisation pour les surfaces d'outils d'agents, conçu pour éviter l'encombrement de la fenêtre de contexte lors de la connexion de plusieurs MCP servers ou API REST. Au lieu d'injecter chaque définition d'outil dans le contexte d'un modèle, ce système compile une fédération d'outils en un point de terminaison unique et rationalisé. Les développeurs peuvent diriger le moteur vers des MCP servers existants, des spécifications OpenAPI ou même des pages de documentation pour générer une surface d'outils plus intelligente.
Les utilisateurs peuvent l'exécuter localement via un CLI ou utiliser le service hébergé sur toolc.dev pour obtenir des points de terminaison HTTPS gérés et un explorateur de logs. Le processus de compilation inclut la réécriture des descriptions pour une meilleure compréhension par les LLM, la consolidation des outils quasi identiques en outils de façade uniques, et la compression de l'ensemble du catalogue derrière des méta-outils tels que search_tools et call_tool. Pour effectuer les passes de réécriture et de consolidation, le système nécessite une ANTHROPIC_API_KEY. La surface résultante peut être servie via stdio pour une utilisation dans des clients comme Claude ou en tant qu'API REST standard.
Ce que vous pouvez faire avec
- 1Réduire les coûts de tokensMinimisez les dépenses liées aux tâches des agents en compressant les définitions d'outils et en résumant les résultats trop volumineux.
- 2Intégrer des API RESTAjoutez des services web externes aux capacités de votre agent en utilisant une spécification OpenAPI ou de la documentation.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer toolc MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller toolc MCP dans Claude Code
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cliInstaller toolc MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Installer toolc MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"toolc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Installer toolc MCP dans VS Code CLI
$ code --add-mcp '{"name":"toolc","type":"stdio","command":"npx","args":["-y","@toolc/cli"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>"}}'Installer toolc MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Installer toolc MCP dans Codex
$ codex mcp add toolc --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -- npx -y @toolc/cliInstaller toolc MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.toolc] command = "npx" args = ["-y", "@toolc/cli"] [mcp_servers.toolc.env] ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>"
Installer toolc MCP dans Gemini CLI
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc npx -- -y @toolc/cliInstaller toolc MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Configuration
ANTHROPIC_API_KEYSecretEnables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface.
| Nom | Description | Type |
|---|---|---|
| ANTHROPIC_API_KEY | Enables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface. | Secret |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibletoolc-dev/toolc is public and reachablegithub.com/toolc-dev/toolc ↗Réussi
- Le nom du package correspond au dépôt source@toolc/cli names toolc-dev/toolc as sourcenpmjs.com/package/@toolc/cli ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-09-15github.com/toolc-dev/toolc ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @toolc/cliRéussi
- Aucun avis critique dans le package ou ses dépendances102 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubtoolc
The optimizing compiler for agent tool surfaces. Point it at your MCP servers, or just a REST API's OpenAPI spec, or even a docs page, and get back one endpoint that serves a smaller, smarter tool surface: cheaper for every agent that connects, more accurate on every task, with every call logged.
Connecting N MCP servers dumps every tool definition into the model's context, degrades tool selection, and forces improvised multi-hop call chains. toolc compiles the federation instead:
- Rewrite: LLM-optimized descriptions with sibling disambiguation
- Consolidate: families of near-duplicate tools (
search_x/find_x/get_x) merge into single facade tools with deterministic routing - Selection: the whole catalog compresses behind two meta-tools
(
search_tools/call_tool) when you want maximum context savings - Compaction: oversized results are summarized at serve time, preserving identifiers and sourcing details
- Compose: REST APIs join the pool straight from an OpenAPI spec, or from a drafted spec synthesized from their documentation
- Observe: every call logged with arguments and results; recurring errors cluster into recommended fixes
Benchmark
131 tools across 5 live servers, 30 tasks × 3 trials, judged answers (full grid · consolidation run):
| condition | success | cost / completed task | tool-def context |
|---|---|---|---|
| raw (all 131 tools) | 96.7% | $0.2631 | ~24,360 tok |
| compiled + consolidate | 96.7% | $0.0411 (6.4× cheaper) | ~845 tok |
| consolidate, no selection | 100.0% | $0.1335 | ~14,506 tok |
Consolidation dominates both ends of the frontier: the selection surface is the cost lever, consolidation lifts accuracy everywhere. Every pass is a config toggle; pick the tradeoff per deployment.
Quick start
git clone https://github.com/toolc-dev/toolc && cd toolc
pnpm install && pnpm -r test
# describe your federation
cp toolc.config.example.jsonc toolc.config.jsonc
# introspect it
node packages/cli/bin/toolc.mjs -c toolc.config.jsonc inspect
# compile (set ANTHROPIC_API_KEY for the rewrite/consolidate passes)
node packages/cli/bin/toolc.mjs -c toolc.config.jsonc compile
# serve the compiled surface over stdio (add to Claude as an MCP server)
node packages/cli/bin/toolc.mjs -c toolc.config.jsonc serve --mode compiled
A downstream can be an MCP server or a bare REST API:
{
"downstream": [
{ "id": "gh", "transport": { "type": "http", "url": "https://api.githubcopilot.com/mcp/" } },
{ "id": "nws", "transport": { "type": "openapi", "spec": "https://api.weather.gov/openapi.json" } }
]
}
See SELF_HOSTING.md for Docker deployment.
Hosted
toolc.dev runs this same engine as a managed service: compiled HTTPS endpoints, a console with a playground and full-payload log explorer, docs-to-spec drafting, and error-driven fix recommendations.
Layout
packages/core: IR (Capability Graph), frontends (MCP, OpenAPI, docs synthesis), passes, emitpackages/gateway: runtime MCP server (mirror + compiled) with call logging and compactionpackages/cli: thetoolccommandpackages/harness: benchmark runner, grading, reportspackages/shared: config schema, errors
License
The engine (everything in this repository) is Apache-2.0, forever: anyone can compile and serve their own tool surfaces locally with the exact same compilation quality as the hosted product.
Questions sur toolc MCP
Comment ajouter toolc MCP à Claude Code ?
Exécutez claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cli dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter toolc MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Puis-je utiliser mes propres API REST avec toolc ?
Oui, vous pouvez inclure des API REST en fournissant une spécification OpenAPI ou en utilisant une spécification rédigée à partir de la documentation.
toolc supporte-t-il le déploiement local ?
Oui, le moteur est sous licence Apache-2.0 et vous permet de compiler et de servir des surfaces d'outils localement via le CLI.
De combien toolc peut-il réduire les coûts ?
Les benchmarks montrent que les surfaces d'outils compilées et consolidées peuvent être jusqu'à 6,4 fois moins coûteuses que l'utilisation d'outils bruts.