{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_cwd2hxptta46","handle":"ai-mcp-server","url":"https://wellknown.network/agents/ai-mcp-server","links":{"self":"https://wellknown.network/agents/ai-mcp-server/record.json","html":"https://wellknown.network/agents/ai-mcp-server","markdown":"https://wellknown.network/agents/ai-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/ai-mcp-server","status":"https://wellknown.network/api/v1/agents/ai-mcp-server/status","claim":"https://wellknown.network/agents/ai-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ai-mcp-server/claim.json","badge":"https://wellknown.network/agents/ai-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:ai-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ai-mcp-server","summary":"本地 MCP 橋樑：把多個 API key + endpoint 收編為統一的模型能力池，給 Agent 透過 MCP 調用","description":"# ai-mcp-server\n\n**Languages:** English | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md)\n\nLocal MCP bridge: register multiple (api_key, base_url) pairs once, and let your Agent\nautomatically discover and route to any model with the right capability (chat, vision,\nreasoning, embedding, image_gen, tts, stt, rerank).\n\nThree entry points:\n- **`ai-mcp`** — CLI (manage endpoints, query models, trigger probes, init wizard)\n- **`ai-mcp-server`** — MCP stdio server, launched by Claude Desktop / Cursor / Cline / Trae\n- **`ai-mcp ui`** — local Web management dashboard (FastAPI + Jinja2, bound to 127.0.0.1)\n\n## Install\n\n### Option 1: uv (recommended)\n\n```bash\nuv tool install ai-mcp-server\n```\n\n### Option 2: Homebrew\n\n```bash\nbrew install brianMacao/tap/ai-mcp-server\n```\n\n### Option 3: npm / npx\n\n```bash\nnpx ai-mcp-server      # auto-installs uv + Python package\n```\n\n### Option 4: pip\n\n```bash\npip install ai-mcp-server\n```\n\n## Quickstart\n\n```bash\n# Interactive first-run wizard\nai-mcp init\n\n# Or step by step:\nai-mcp endpoint add --name openrouter --base-url https://openrouter.ai/api/v1 --key sk-...\nai-mcp endpoint probe openrouter\nai-mcp model list --capability vision\n\n# Start the Web UI\nai-mcp ui\n# → http://127.0.0.1:8765/\n\n# Start the MCP server (for Claude Desktop, Cursor, etc.)\nai-mcp-server\n```\n\n## MCP Tools\n\n`ai-mcp-server` exposes 6 MCP tools:\n\n- `usage_guide` — dynamic inventory, capability distribution, and routing guidance.\n- `list_models` — filter models by capability, context length, endpoint, and probe state.\n- `invoke_model` — pass through chat / embedding / image_gen / tts / stt / rerank calls;\n  TTS audio is returned as `audio_base64` inside the JSON body.\n- `model_performance` — inspect recent per-model call counts, success rate, and latency.\n- `refresh_endpoint` — refresh model lists and enqueue asynchronous capability probes.\n- `add_models` — manually register models for endpoints without `/v1/models`, or let an\n  Agent register user-confirmed model feature…","publisher":null,"homepage":"https://github.com/brianMacao/ai-mcp-server","repository":"https://github.com/brianMacao/ai-mcp-server","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["ai","llm","mcp","model-context-protocol","model-pool","openai-compatible"],"pricing":null,"endpoints":[{"url":"pypi:ai-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.756,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"ai-mcp-server","registry":"pypi","observedAt":"2026-09-09T08:22:42.282Z","publishedAt":"2026-06-29T08:33:35.206948Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ai-mcp-server","url":"https://pypi.org/project/ai-mcp-server/","firstSeenAt":"2026-09-09T08:21:44.654Z","fetchedAt":"2026-09-09T08:21:44.654Z","normalizedAt":"2026-09-09T08:21:44.654Z"}]},"firstSeenAt":"2026-09-09T08:21:44.654Z","updatedAt":"2026-09-09T08:22:42.282Z"}