Claude (Code / Desktop) ──stdio──> server.py ──┬─ /mcp 转发（30 个官方工具）──> 各 arthas agent
                                       │读      └─ /api 执行（list_agents/help/execute）
                                       ├─ agents.yaml      （agent 清单 + tags）
                                       └─ arthas_tools.json（官方 30 工具 schema，固化）

.venv/bin/python -c "
import asyncio, json
from fastmcp import Client
from fastmcp.client.transports import StreamableHttpTransport
tp = StreamableHttpTransport('http://xx.xx.xx.xx:8563/mcp', headers={'Authorization':'Bearer arthas'})
async def main():
    async with Client(tp) as c:
        tools = await c.list_tools()
        json.dump([{'name':t.name,'description':t.description,'inputSchema':t.inputSchema} for t in tools],
                  open('arthas_tools.json','w'), ensure_ascii=False, indent=2)
        print('refreshed', len(tools))
asyncio.run(main())
"

agents:
  - name: "xxx服务"
    url: http://xx.xx.xx.xx:8563
    tags: ["测试", "IC", "biz"]   # 打标签，便于 list_agents(tag=...) 批量定位
defaults:
  username: arthas     # 公共账号，所有 agent 共用（个别不同可在该 agent 下覆盖）
  password: arthas
  auth: basic          # basic | bearer
  exec_timeout_ms: 10000
  confirm_commands: [stop, redefine, retransform, mc, reset]  # 灰名单：执行前需用户确认
  blocked_commands: []                                        # 黑名单：完全禁用、不暴露

cd /path/to/arthas-mcp-proxy
uv venv && uv pip install fastmcp httpx pyyaml

claude mcp add arthas-proxy --scope local -- \
  /path/to/arthas-mcp-proxy/.venv/bin/python /path/to/arthas-mcp-proxy/server.py

"arthas-proxy": {
  "command": "/path/to/arthas-mcp-proxy/.venv/bin/python",
  "args": ["/path/to/arthas-mcp-proxy/server.py"]
}

.venv/bin/python -c "
import asyncio, server
from fastmcp import Client
async def main():
    async with Client(server.mcp) as c:
        print('工具数:', len(await c.list_tools()))
        r = await c.call_tool('jvm', {'target':'xxx服务'})
        print(r.content[0].text[:120])
asyncio.run(main())
"