AdvancedSharpAdbClient v3.6.16 - Full MCP Server
Created: 2026-01-28 Status: ✅ Production Ready
📋 MỤC LỤC
- README_MCP_FULL.md - Setup Guide đầy đủ
- SharpAdb_Agent_Complete.md - Agent Documentation (93 KB)
- OPTIMIZATION_PLAN.md - Phân tích tối ưu hóa
- MISSING_FOR_AGENT.md - Gap analysis
🎯 GIỚI THIỆU
FULL MCP Server cho AdvancedSharpAdbClient với 18 tools bao gồm:
- ✅ UI Automation (FindElement với XPath, Click, Swipe, SendText)
- ✅ App Management (Start, Stop, Install, Uninstall, List Packages)
- ✅ File Operations (Pull, List Directory)
- ✅ Device Management (Connect, Disconnect, Get State)
📦 CẤU TRÚC
AdvancedSharpAdbClient-mcp/
├── AdvancedSharpAdbClient.CLI/ # C# CLI Wrapper
│ ├── Program.cs # 18 commands source
│ └── bin/Release/net10.0/win-x64/publish/
│ └── AdvancedSharpAdbClient.CLI.exe # ⭐ Executable
├── .mcp-wrapper/ # Node.js MCP Server
│ ├── src/
│ │ └── index-full.ts # MCP server source
│ ├── build/
│ │ └── index-full.js # ⭐ Entry point
│ ├── package.json
│ └── tsconfig.json
├── package.json # Root package config
├── README.md # This file
├── README_MCP_FULL.md # ⭐ SETUP GUIDE
├── SharpAdb_Agent_Complete.md # Agent documentation
├── OPTIMIZATION_PLAN.md # Analysis
└── MISSING_FOR_AGENT.md # Gap analysis⚡ QUICK START
Bước 1: Verify files exist
# Check executable
dir "D:\Antigravity\MCP\AdvancedSharpAdbClient-mcp\AdvancedSharpAdbClient.CLI\bin\Release\net10.0\win-x64\publish\AdvancedSharpAdbClient.CLI.exe"
# Check MCP server
dir "D:\Antigravity\MCP\AdvancedSharpAdbClient-mcp\.mcp-wrapper\build\index-full.js"Bước 2: Add to Claude Config
Edit ~/.claude/config.json:
{
"mcpServers": {
"advancedsharpAdbclient-mcp": {
"command": "node",
"args": [
"D:\\Antigravity\\MCP\\AdvancedSharpAdbClient-mcp\\.mcp-wrapper\\build\\index-full.js"
],
"env": {
"ADB_CLI_PATH": "D:\\Antigravity\\MCP\\AdvancedSharpAdbClient-mcp\\AdvancedSharpAdbClient.CLI\\bin\\Release\\net10.0\\win-x64\\publish\\AdvancedSharpAdbClient.CLI.exe"
}
}
}
}Bước 3: Restart Claude Code
- Thoát Claude Code
- Mở lại
- Test:
@advancedsharpAdbclient-mcp→ Sẽ thấy 18 tools
📚 DOCUMENTATION
1. README_MCP_FULL.md (⭐ Đọc đầu tiên)
- Setup instructions đầy đủ
- 18 tools available
- Usage examples
- Troubleshooting
2. SharpAdb_Agent_Complete.md (93 KB)
- 30 Use Cases
- 15 Skill Templates
- 100+ Natural Language Patterns
- Error Handling Guide
- Performance & Prerequisites
3. OPTIMIZATION_PLAN.md
- Phân tích 25 mục cần xoá
- Giảm từ 1.4 MB → 93 KB (93%)
- Impact scoring
4. MISSING_FOR_AGENT.md
- 12 critical gaps identified
- Use Cases, Workflows, Patterns
- Completion roadmap
🛠️ 18 TOOLS
| Category | Tools | Count |
|---|---|---|
| Device Management | devices, connect, disconnect, get-state | 4 |
| UI Automation | find-element, find-elements, click, swipe, send-text, send-key-event, get-ui-hierarchy | 7 |
| App Management | start-app, stop-app, install-apk, uninstall-app, list-packages | 5 |
| File Operations | pull-file, list-directory | 2 |
| Total | 18 |
💡 USAGE EXAMPLE
User: "Find Login button on device 127.0.0.1:62001 and click it"
Claude will call:
1. @advancedsharpAdbclient-mcp adb_find_element
→ Returns: { "text": "Login", "bounds": { "left": 100, "top": 500 } }
2. @advancedsharpAdbclient-mcp adb_click
→ Clicks at (100, 500)🚀 PUSH TO GITHUB
cd "D:\Antigravity\MCP\AdvancedSharpAdbClient-mcp"
# Initialize git
git init
git add .
git commit -m "Initial commit: Full MCP server with 18 tools"
# Push to GitHub
git remote add origin https://github.com/your-username/advancedsharpAdbclient-mcp.git
git branch -M main
git push -u origin main📊 SPECIFICATIONS
| Metric | Value |
|---|---|
| Total Size | ~5 MB (with C# dependencies) |
| Tools | 18 |
| Documentation | 93 KB + Guides |
| Languages | C# (.NET 10) + TypeScript (Node.js) |
| API Version | AdvancedSharpAdbClient 3.6.16 |
| MCP SDK | @modelcontextprotocol/sdk ^0.5.0 |
✅ VERIFICATION
Test commands:
# 1. Test C# CLI
cd "D:\Antigravity\MCP\AdvancedSharpAdbClient-mcp\AdvancedSharpAdbClient.CLI\bin\Release\net10.0\win-x64\publish"
.\AdvancedSharpAdbClient.CLI.exe devices
# 2. Test MCP Server
cd "D:\Antigravity\MCP\AdvancedSharpAdbClient-mcp\.mcp-wrapper"
node build/index-full.js
# Input: {"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}
# 3. Test in Claude
# Type: @advancedsharpAdbclient-mcp
# Should autocomplete with 18 tools🔗 LINKS
- Main Guide: README_MCP_FULL.md
- Agent Doc: SharpAdb_Agent_Complete.md
- Original Library: https://github.com/yungd1plomat/AdvancedSharpAdbClient
📝 NOTES
- C# executable requires .NET 10 runtime
- All commands output JSON format
- Shell command removed (ConsoleOutputReceiver not available)
- Push file removed (UnixFileStatus enum not available)
- Pull file works with default permissions
Created: 2026-01-28 Version: 2.0.0 Status: ✅ Ready for production use