Birden fazla MCP server ve REST API'yi, bağlam kullanımını azaltmak ve agent doğruluğunu artırmak için tek bir optimize edilmiş araç uç noktası (endpoint) halinde derler.
Ayrıca bilinen adı toolc-dev/toolc, @toolc/cli
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.1
- Son commit
- 15 Eyl 2026
- Lisans
- Apache-2.0
toolc MCP nedir?
toolc bir MCP sunucusudur. Birden fazla MCP server ve REST API'yi, bağlam kullanımını azaltmak ve agent doğruluğunu artırmak için tek bir optimize edilmiş araç uç noktası (endpoint) halinde derler.
Özet, projenin README dosyasından oluşturuldu
toolc MCP sunucusu hakkında
toolc, birden fazla MCP server veya REST API bağlanırken bağlam penceresinin (context window) şişmesini önlemek için tasarlanmış, agent araç yüzeyleri için optimize edici bir derleyici görevi görür. Her bir araç tanımını modelin bağlamına boşaltmak yerine, bu sistem bir araç federasyonunu tek bir akıcı uç noktaya derler. Geliştiriciler, daha akıllı bir araç yüzeyi oluşturmak için motoru mevcut MCP server'lara, OpenAPI spesifikasyonlarına ve hatta dokümantasyon sayfalarına yönlendirebilirler.
Kullanıcılar bunu yerel olarak bir CLI aracılığıyla çalıştırabilir veya yönetilen HTTPS uç noktaları ve bir log gezgini için toolc.dev adresindeki barındırılan hizmeti kullanabilirler. Derleme süreci; LLM'lerin daha iyi anlaması için açıklamaların yeniden yazılmasını, birbirine çok benzeyen araçların tek bir facade araç altında birleştirilmesini ve tüm kataloğun search_tools ve call_tool gibi meta araçlar arkasında sıkıştırılmasını içerir. Yeniden yazma ve birleştirme işlemlerini gerçekleştirmek için sistem bir ANTHROPIC_API_KEY gerektirir. Elde edilen yüzey, Claude gibi istemcilerde kullanılmak üzere stdio üzerinden veya standart bir REST API olarak sunulabilir.
Neler yapabilirsiniz
- 1Token maliyetlerini azaltınAraç tanımlarını sıkıştırarak ve aşırı büyük sonuçları özetleyerek agent görevlerinin maliyetini minimize edin.
- 2REST API'leri entegre edinBir OpenAPI spesifikasyonu veya dokümantasyon kullanarak harici web servislerini agent yeteneklerinize ekleyin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
toolc MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekletoolc MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/clitoolc MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}toolc MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"toolc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}toolc MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"toolc","type":"stdio","command":"npx","args":["-y","@toolc/cli"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>"}}'toolc MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}toolc MCP'yi Codex içine yükleyin
$ codex mcp add toolc --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -- npx -y @toolc/clitoolc MCP'yi Codex config.toml içine yükleyin
~/.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'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc npx -- -y @toolc/clitoolc MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Yapılandırma
ANTHROPIC_API_KEYGizliEnables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface.
| Ad | Açıklama | Sunucu |
|---|---|---|
| ANTHROPIC_API_KEY | Enables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface. | Gizli |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirtoolc-dev/toolc is public and reachablegithub.com/toolc-dev/toolc ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@toolc/cli names toolc-dev/toolc as sourcenpmjs.com/package/@toolc/cli ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-09-15github.com/toolc-dev/toolc ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @toolc/cliGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok102 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
toolc
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 soruları
toolc MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cli komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
toolc MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Kendi REST API'lerimi toolc ile kullanabilir miyim?
Evet, bir OpenAPI spesifikasyonu sağlayarak veya dokümantasyondan sentezlenmiş taslak bir spesifikasyon kullanarak REST API'leri dahil edebilirsiniz.
toolc yerel kurulumu destekliyor mu?
Evet, motor Apache-2.0 lisanslıdır ve CLI kullanarak araç yüzeylerini yerel olarak derlemenize ve sunmanıza olanak tanır.
toolc maliyetleri ne kadar azaltabilir?
Benchmark sonuçları, derlenmiş ve birleştirilmiş araç yüzeylerinin ham araçları kullanmaya kıyasla 6.4 kata kadar daha ucuz olabileceğini göstermektedir.