Agentic MCP server
2026년 10월 22일 커밋3단계 레이지 로딩(lazy loading)을 통해 AI 클라이언트가 필요할 때마다 MCP server를 검색하고 호출할 수 있게 하여, 전체 도구 목록을 미리 설치하지 않고도 토큰 사용량을 줄여줍니다.
다른 이름 cablate/Agentic-MCP-Skill
- 스타
- 41
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 22일
- 라이선스
- —
Agentic MCP란?
Agentic은(는) MCP server입니다. 3단계 레이지 로딩(lazy loading)을 통해 AI 클라이언트가 필요할 때마다 MCP server를 검색하고 호출할 수 있게 하여, 전체 도구 목록을 미리 설치하지 않고도 토큰 사용량을 줄여줍니다.
프로젝트 README에서 생성된 요약
Agentic MCP server 정보
AI 컨텍스트 윈도우 사용량을 최적화하려는 개발자는 점진적 공개(progressive disclosure) 전략을 통해 Model Context Protocol server를 관리하는 이 도구를 사용할 수 있습니다. 모든 사용 가능한 도구를 AI 클라이언트에 한꺼번에 로드하면 상당한 토큰이 소비되지만, 이 시스템은 3단계 접근 방식을 사용하여 필요한 정보만 가져옵니다. 기본 서버 메타데이터로 시작하여 도구 목록으로 넘어가고, 마지막으로 도구를 호출할 준비가 되었을 때만 특정 입력 스키마를 로드합니다.
이 실험적 프로젝트는 Playwright나 filesystem 도구와 같은 다양한 MCP server와 지속적인 연결을 유지하는 소켓 기반 데몬 아키텍처를 통해 작동합니다. 사용자는 JSON 파일을 통해 환경을 구성하고 CLI를 사용하여 시스템과 상호작용합니다. 이러한 레이지 로딩 패턴을 구현함으로써 개발자는 상당한 토큰 절약 효과를 얻을 수 있으며, 기존 방식과 비교했을 때 대규모 도구 세트를 관리하는 비용을 80% 이상 절감할 수 있습니다.
활용 사례
- 1AI 토큰 소비 감소AI 클라이언트가 사용 가능한 도구를 탐색하고, 사용하려는 특정 도구에 대해서만 전체 입력 스키마를 로드할 수 있습니다.
- 2다중 MCP server 관리개발자는 단일 데몬을 통해 Playwright 또는 GitHub와 같은 다양한 MCP server를 구성하고 실행할 수 있습니다.
- 3웹 브라우저 작업 자동화Playwright 통합을 사용하여 AI에게 웹사이트 탐색, 스크린샷 찍기 또는 요소 클릭 등을 지시할 수 있습니다.
- 4서버 설정 실시간 업데이트설정 파일에서 서버 목록을 수정하고 데몬을 중단하지 않고 변경 사항을 즉시 적용할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능cablate/agentic-mcp-skill is public and reachablegithub.com/cablate/agentic-mcp-skill ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-22github.com/cablate/agentic-mcp-skill ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Agentic-MCP with Skill
AgentSkill for MCP - Three-layer progressive disclosure validates AgentSkills.io pattern for efficient MCP token usage
Design Intent
Proven AgentSkills Pattern
In the AgentSkills.io ecosystem, Progressive Disclosure combined with Script linkage has been validated as effective:
- AI only loads specific information when needed, significantly reducing token usage
- Scripts can be invoked via AI commands, providing high customization potential
- Sharing tools via scripts is far less costly than developing and using complex MCP Servers
The impact of this pattern is significant and substantial.
Current MCP Skill Dilemma
Despite this, many Skills using MCP still face two extreme options:
Option 1: Install MCP directly in Claude Code, Skill only guides AI to call MCP
- MCP server occupies AI context long-term
- Full tool list loaded every conversation
- Token waste, and MCP itself cannot be progressively explored
Option 2: Write custom scripts yourself
- Tests user's programming skills
- High customization but lacks standards
- Each MCP has its own format/specs, high adaptation cost for both open and closed source
- Difficult to maintain and share
This Skill's Goal
Validate whether AgentSkills.io pattern applies to improving MCP usage
This concept validation attempts to port AgentSkills' successful pattern to the MCP domain:
- Can AgentSkills architecture apply to MCP server management?
- Is three-layer progressive disclosure effective in MCP scenarios?
- Is Socket-based daemon architecture more practical than direct MCP usage?
Experimental Nature
This is not a mature product, but an experiment:
- Test AgentSkills pattern applicability in MCP domain
- Explore actual effectiveness of three-layer loading
- Validate pros/cons of Daemon architecture
- Serve as reference prototype for future development
Important Disclaimer
This is a very early, rushed AI-assisted demo version with current goals:
- Validate concept feasibility
- Explore usage patterns
- Collect feedback for improvements
Not recommended for production use. Expect many issues and optimization opportunities. If you find any problems or have suggestions, please open an Issue or contribute a PR.
Core Concepts
Three-Layer Progressive Disclosure
Like AgentSkills, you don't need to load everything at once:
Layer 1: Know which servers are available
Load only basic info (name, version, status)
Usage: ~50-100 tokens
Use case: Check availability, choose server
Layer 2: Know what tools this server provides
Load tool list (names + brief descriptions)
Usage: ~200-400 tokens
Use case: Browse available tools, decide what to use
Layer 3: Load only the tools you need
Load complete input format for specific tool
Usage: ~300-500 tokens/tool
Use case: Before calling tool
Why This Approach
Assume an MCP server has 20 tools, you only need 2:
| Loading Method | Token Usage | Description |
|---|---|---|
| Load All | 6,000 | 20 tools × 300 tokens |
| Three-Layer Progressive | 850 | Metadata(50) + List(200) + 2 tools(600) |
| Savings | 86% | Only load what you need |
Development Status
Future Plans
Based on concept validation results, future directions include:
Short-term Goals
- More convenient MCP Servers management (UI, auto-discovery, one-click install)
- Implement Auth features (API Key management, permission control)
Mid-term Goals
- Enhance MCP Server tool calling experience (better error messages, parameter validation, result formatting)
- Intercept MCP Server output with customizable Script data processing, avoid massive messy data entering conversation memory
This project's direction depends on:
- Concept validation results
- Community feedback
- Actual usage needs
Feedback and suggestions welcome.
Quick Start
Prerequisites
- Node.js >= 18.0.0
- npm
1. Install from npm (Recommended)
# Install globally
npm install -g @cablate/agentic-mcp
# Verify installation
agentic-mcp --version
# Start daemon
agentic-mcp daemon start
2. Configure
Edit mcp-servers.json in the project root:
{
"servers": {
"playwright": {
"description": "Browser automation tool for web navigation, screenshots, clicks, form filling, and more",
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest", "--isolated"]
}
}
}
3. Start Daemon
node dist/cli/index.js daemon start --config <config-path>
4. Test Connection
# Check daemon health
agentic-mcp daemon health
# Layer 1: Check server status
agentic-mcp metadata playwright
# Layer 2: List available tools
agentic-mcp list playwright
# Layer 3: View specific tool format
agentic-mcp schema playwright browser_navigate
5. Call Tool
agentic-mcp call playwright browser_navigate --params '{"url": "https://example.com"}'
Testing
This project uses Vitest for testing with the following test suites:
Running Tests
# Run tests in watch mode
npm test
# Run tests once
npm run test:run
# Run with coverage report
npm run test:coverage
Test Structure
tests/
├── unit/
│ ├── client.test.ts # ProgressiveMCPClient tests (12 tests)
│ ├── socket-client.test.ts # SocketClient tests (7 tests)
│ └── cli/
│ └── commands.test.ts # CLI command tests (6 tests)
Current Coverage
- Statements: 61.71%
- Branches: 47.29%
- Functions: 65.85%
- Lines: 61.53%
Test coverage focuses on core modules (client.ts, socket-client.ts). Daemon integration tests are deferred to future work.
Test Philosophy
This project follows a pragmatic progressive approach:
- Focus on happy path testing first
- Use real MCP server (
@modelcontextprotocol/server-filesystem) for integration - Mock only where necessary (e.g.,
netmodule for SocketClient) - Defer complex scenarios (daemon socket tests) to keep initial implementation simple
Usage Examples
Web Automation
Automate browser operations using Playwright MCP server:
# 1. Navigate to website
agentic-mcp call playwright browser_navigate --params '{"url": "https://www.apple.com/tw"}'
# 2. Take screenshot
agentic-mcp call playwright browser_take_screenshot
# 3. Click element
agentic-mcp call playwright browser_click --params '{"element": "Mac link", "ref": "e19"}'
Hot Reload Configuration
Reload after modifying mcp-servers.json without restarting daemon:
agentic-mcp daemon reload
Response example:
✓ Configuration reloaded
Old servers: playwright_global
New servers: playwright_global, filesystem_global
Architecture
System Architecture
+-----------------------------+
| AI / CLI Layer |
| (CLI commands) |
| - agentic-mcp metadata |
| - agentic-mcp list |
| - agentic-mcp schema |
| - agentic-mcp call |
+-----------+-----------------+
| Socket (newline-delimited JSON)
v
+-----------------------------+
| MCP Daemon (Long-Running) |
| - Maintain persistent MCP |
| connections |
| - Socket communication |
| - Manage shared sessions |
| - Support Hot Reload |
+-----------+-----------------+
| MCP Protocol
v
+-----------------------------+
| MCP Servers |
| - playwright (browser) |
| - filesystem (files) |
| - github (Git) |
| - custom servers |
+-----------------------------+
Configuration
MCP Servers Configuration
Edit mcp-servers.json:
{
"servers": {
"playwright": {
"description": "Browser automation tool for web navigation, screenshots, clicks, and form filling",
"transportType": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest", "--isolated"]
}
}
}
Configuration Notes:
description(optional): Server description for AI to understand the MCP server's purpose. If not provided, Layer 1 metadata will not include this field.
Resources
- SKILL.md - Complete usage guide
- docs/AGENT_BROWSER_DESIGN_PATTERNS.md - Design patterns learned from agent-browser
- MCP Specification
- MCP TypeScript SDK
- AgentSkills.io
This is a concept validation project, feedback welcome
Agentic MCP 질문
Agentic-MCP는 어떻게 MCP 토큰 사용량을 줄이나요?
MCP 정보를 3단계로 로드합니다. 먼저 서버 메타데이터를 로드하고, 그다음 도구 목록을, 마지막으로 실제로 호출하는 도구에 대해서만 전체 스키마를 로드합니다. README에 따르면 서버에 도구가 많지만 실제로는 소수만 사용하는 경우 토큰을 약 86% 절약할 수 있습니다.
agentic-mcp는 어떤 명령어를 제공하나요?
metadata, list, schema, call을 위한 CLI 명령어를 제공하며, daemon start, health, reload 명령어도 포함되어 있습니다. 이 명령어들은 3단계 정보 공개 레이어 및 도구 호출 기능과 매핑됩니다.
Agentic-MCP를 어떻게 설치하고 시작하나요?
npm을 통해 전역으로 설치한 후, 설정 파일을 사용하여 daemon start 명령어로 데몬을 시작합니다. Node.js 18 이상 버전이 필요합니다.
MCP server는 어떻게 설정하나요?
mcp-servers.json 파일에 설명, transport type, command, args를 정의하여 서버를 지정합니다. 파일을 수정한 후 데몬을 reload하면 재시작 없이 새로운 서버를 적용할 수 있습니다.