Agentic MCPサーバー
コミット 2026年10月22日3層のレイジーローディングにより、AIクライアントが必要に応じてMCP serverを検出・呼び出しできるようにします。ツールリストを事前にすべてインストールすることなく、トークン使用量を削減できます。
別名 cablate/Agentic-MCP-Skill
- スター
- 41
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年10月22日
- ライセンス
- —
Agentic MCPとは
AgenticはMCPサーバーです。 3層のレイジーローディングにより、AIクライアントが必要に応じてMCP serverを検出・呼び出しできるようにします。ツールリストを事前にすべてインストールすることなく、トークン使用量を削減できます。.
プロジェクトのREADMEから生成された概要
Agentic MCP server について
AIのコンテキストウィンドウの使用量を最適化したい開発者は、段階的な開示戦略を通じてModel Context Protocolサーバーを管理するためにこのツールを利用できます。利用可能なすべてのツールを一度にAIクライアントに読み込むと大量のトークンを消費しますが、このシステムは3層のアプローチを採用し、必要な情報のみを取得します。まず基本的なサーバーのメタデータから始まり、次にツールリスト、そして最後にツールを呼び出す準備ができたときにのみ、特定の入力スキーマを読み込みます。
この実験的なプロジェクトは、ソケットベースのデーモンアーキテクチャを介して動作し、PlaywrightやfilesystemツールなどのさまざまなMCP serverへの永続的な接続を維持します。ユーザーはJSONファイルを通じて環境を設定し、コマンドラインインターフェースを使用してシステムとやり取りします。このレイジーローディングパターンを実装することで、開発者は大幅なトークン節約を実現でき、従来のメソッドと比較して、大規模なツールセットの管理コストを80%以上削減できる可能性があります。
できること
- 1AIトークン消費量の削減AIクライアントは利用可能なツールをブラウズし、使用しようとしている特定のツールに対してのみ完全な入力スキーマを読み込むことができます。
- 2複数のMCP serverの管理開発者は、PlaywrightやGitHubなどのさまざまなMCP serverを単一のデーモンを通じて設定・実行できます。
- 3Webブラウザ操作の自動化Playwrightの統合を使用して、AIにWebサイトのナビゲーション、スクリーンショットの取得、要素のクリックなどを指示できます。
- 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に、説明、トランスポートタイプ、command、argsを定義して指定します。編集後にデーモンをリロードすることで、再起動することなく新しいサーバーを反映できます。