Fasst mehrere MCP server und REST APIs zu einem einzigen, optimierten Tool-Endpoint zusammen, um den Context-Verbrauch zu senken und die Genauigkeit von Agenten zu verbessern.
Auch bekannt als toolc-dev/toolc, @toolc/cli
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.1
- Letzter Commit
- 15. Sept. 2026
- Lizenz
- Apache-2.0
Was ist toolc MCP?
toolc ist ein MCP server. Fasst mehrere MCP server und REST APIs zu einem einzigen, optimierten Tool-Endpoint zusammen, um den Context-Verbrauch zu senken und die Genauigkeit von Agenten zu verbessern.
Zusammenfassung generiert aus dem README des Projekts
Über toolc MCP server
toolc fungiert als optimierender Compiler für Agent Tool-Oberflächen und wurde entwickelt, um Context-Window-Bloat zu verhindern, wenn mehrere MCP server oder REST APIs verbunden werden. Anstatt jede einzelne Tool-Definition in den Context eines Modells zu werfen, kompiliert dieses System eine Föderation von Tools zu einem einzigen, schlanken Endpoint. Entwickler können die Engine auf bestehende MCP server, OpenAPI-Spezifikationen oder sogar Dokumentationsseiten ansetzen, um eine intelligentere Tool-Oberfläche zu generieren.
Nutzer können dies lokal über ein CLI ausführen oder den Hosted-Service unter toolc.dev für verwaltete HTTPS-Endpoints und einen Log-Explorer nutzen. Der Kompilierungsprozess beinhaltet das Umschreiben von Beschreibungen für ein besseres LLM-Verständnis, das Konsolidieren von nahezu identischen Tools zu einzelnen Facade-Tools und das Komprimieren des gesamten Katalogs hinter Meta-Tools wie search_tools und call_tool. Um die Rewrite- und Consolidate-Durchläufe durchzuführen, benötigt das System einen ANTHROPIC_API_KEY. Die resultierende Oberfläche kann über stdio für die Nutzung in Clients wie Claude oder als standardmäßige REST API bereitgestellt werden.
Was du damit machen kannst
- 1Token-Kosten senkenMinimiere die Kosten für Agent-Tasks, indem Tool-Definitionen komprimiert und überdimensionierte Ergebnisse zusammengefasst werden.
- 2REST APIs integrierenErweitere die Fähigkeiten deines Agenten um externe Web-Services mithilfe einer OpenAPI-Spezifikation oder Dokumentation.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du toolc MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügentoolc MCP in Claude Code installieren
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/clitoolc MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}toolc MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"toolc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}toolc MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"toolc","type":"stdio","command":"npx","args":["-y","@toolc/cli"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>"}}'toolc MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}toolc MCP in Codex installieren
$ codex mcp add toolc --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -- npx -y @toolc/clitoolc MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.toolc] command = "npx" args = ["-y", "@toolc/cli"] [mcp_servers.toolc.env] ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>"
toolc MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc npx -- -y @toolc/clitoolc MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Konfiguration
ANTHROPIC_API_KEYSecretEnables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface.
| Name | Beschreibung | Typ |
|---|---|---|
| ANTHROPIC_API_KEY | Enables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface. | Secret |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbartoolc-dev/toolc is public and reachablegithub.com/toolc-dev/toolc ↗Bestanden
- Paket nennt dieses Repository als Quelle@toolc/cli names toolc-dev/toolc as sourcenpmjs.com/package/@toolc/cli ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-09-15github.com/toolc-dev/toolc ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @toolc/cliBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten102 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehentoolc
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.
toolc MCP Fragen
Wie füge ich toolc MCP zu Claude Code hinzu?
Führe claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cli in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich toolc MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Kann ich meine eigenen REST APIs mit toolc nutzen?
Ja, du kannst REST APIs einbinden, indem du eine OpenAPI-Spezifikation bereitstellst oder eine aus Dokumentationen generierte Spezifikation verwendest.
Unterstützt toolc lokale Deployments?
Ja, die Engine ist unter der Apache-2.0 Lizenz verfügbar und erlaubt es dir, Tool-Oberflächen lokal über das CLI zu kompilieren und bereitzustellen.
Wie stark kann toolc Kosten senken?
Benchmarks zeigen, dass kompilierte und konsolidierte Tool-Oberflächen bis zu 6,4-mal günstiger sein können als die Nutzung von Roh-Tools.