여러 MCP server와 REST API를 하나의 최적화된 도구 엔드포인트로 컴파일하여, 컨텍스트 사용량을 줄이고 에이전트의 정확도를 높입니다.
다른 이름 toolc-dev/toolc, @toolc/cli
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.1.1
- 마지막 커밋
- 2026년 9월 15일
- 라이선스
- Apache-2.0
toolc MCP란?
toolc은(는) MCP server입니다. 여러 MCP server와 REST API를 하나의 최적화된 도구 엔드포인트로 컴파일하여, 컨텍스트 사용량을 줄이고 에이전트의 정확도를 높입니다.
프로젝트 README에서 생성된 요약
toolc MCP server 정보
toolc는 에이전트 도구 인터페이스를 위한 최적화 컴파일러 역할을 하며, 여러 MCP server 또는 REST API를 연결할 때 발생하는 컨텍스트 윈도우 팽창을 방지하도록 설계되었습니다. 모든 도구 정의를 모델의 컨텍스트에 그대로 쏟아붓는 대신, 이 시스템은 연합된 도구들을 하나의 간결한 엔드포인트로 컴파일합니다. 개발자는 기존 MCP server, OpenAPI 사양, 또는 문서 페이지를 엔진에 연결하여 더 스마트한 도구 인터페이스를 생성할 수 있습니다.
사용자는 CLI를 통해 로컬에서 실행하거나, 관리형 HTTPS 엔드포인트와 로그 탐색기를 제공하는 toolc.dev 호스팅 서비스를 이용할 수 있습니다. 컴파일 프로세스에는 LLM의 이해도를 높이기 위한 설명 재작성, 유사한 도구들을 하나의 파사드 도구로 통합, 그리고 search_tools 및 call_tool과 같은 메타 도구 뒤로 전체 카탈로그를 압축하는 과정이 포함됩니다. 재작성 및 통합 단계를 수행하려면 ANTHROPIC_API_KEY가 필요합니다. 결과물은 Claude와 같은 클라이언트에서 사용할 수 있도록 stdio를 통해 서빙하거나 표준 REST API로 제공할 수 있습니다.
활용 사례
- 1토큰 비용 절감도구 정의를 압축하고 과도하게 큰 결과값을 요약하여 에이전트 작업 비용을 최소화합니다.
- 2REST API 통합OpenAPI 사양이나 문서를 사용하여 외부 웹 서비스를 에이전트의 기능으로 추가합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
toolc MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 toolc MCP 설치
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cliCursor에 toolc MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}VS Code에 toolc MCP 설치
.vscode/mcp.json
{
"servers": {
"toolc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}VS Code CLI에 toolc MCP 설치
$ code --add-mcp '{"name":"toolc","type":"stdio","command":"npx","args":["-y","@toolc/cli"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>"}}'Claude Desktop에 toolc MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Codex에 toolc MCP 설치
$ codex mcp add toolc --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -- npx -y @toolc/cliCodex config.toml에 toolc MCP 설치
~/.codex/config.toml
[mcp_servers.toolc] command = "npx" args = ["-y", "@toolc/cli"] [mcp_servers.toolc.env] ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>"
Gemini CLI에 toolc MCP 설치
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc npx -- -y @toolc/cliGemini settings.json에 toolc MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}구성
ANTHROPIC_API_KEY비밀Enables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface.
| 이름 | 설명 | 유형 |
|---|---|---|
| ANTHROPIC_API_KEY | Enables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface. | 비밀 |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능toolc-dev/toolc is public and reachablegithub.com/toolc-dev/toolc ↗통과
- 패키지가 이 저장소를 소스로 명시@toolc/cli names toolc-dev/toolc as sourcenpmjs.com/package/@toolc/cli ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-15github.com/toolc-dev/toolc ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @toolc/cli통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음102 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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 질문
toolc MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cli를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
toolc MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
toolc에서 개인 REST API를 사용할 수 있나요?
네, OpenAPI 사양을 제공하거나 문서를 바탕으로 생성된 초안 사양을 사용하여 REST API를 포함할 수 있습니다.
toolc는 로컬 배포를 지원하나요?
네, 엔진은 Apache-2.0 라이선스를 따르며 CLI를 사용하여 로컬에서 도구 인터페이스를 컴파일하고 서빙할 수 있습니다.
toolc를 통해 비용을 얼마나 절감할 수 있나요?
벤치마크 결과에 따르면, 컴파일 및 통합된 도구 인터페이스는 원본 도구를 그대로 사용하는 것보다 최대 6.4배 더 저렴합니다.