📖 Read-only mirror.
aimarket-mcpis published from the canonical AI-Factory monorepo. Pull requests are not accepted — any commit pushed here is overwritten byscripts/mirror_satellites.shon the next sync. 🐞 Found a bug or have a request? Please open an issue.
aimarket-mcp — ecosystem MCP gateway
CI aimarket-mcp MCP server MCP gateway stdio + HTTP 14 tests passing Test coverage License: MIT
One MCP gateway. Three hardened tools. Shared by Metis, ARGUS, and the ecosystem.
Transport: stdio (mcp_stdio_server.py) for Glama / Claude Desktop / Cursor, built with the
official Model Context Protocol Python SDK (mcp, FastMCP).
Also ships Streamable-HTTP on :9090 for self-hosted deployments (aimarket-mcp-http, Docker Compose).
| Item | Location |
|---|---|
| MCP entrypoint (stdio) | mcp_stdio_server.py |
| MCP gateway (HTTP) | aimarket_mcp/server.py |
| Tool handlers + security | aimarket_mcp/tools.py, aimarket_mcp/security.py |
| Glama / Docker (stdio) | Dockerfile, glama.json |
| Self-host HTTP | Dockerfile.http, docker-compose.yml |
Compatible hosts: Claude Desktop, Cursor, Glama, and any MCP client that supports stdio or Streamable-HTTP.
Tools (3)
| Tool | What it does | Hardening |
|---|---|---|
web_fetch | Fetch a URL, return main text (readability-lite) | SSRF-guarded; output sanitized + <untrusted>-wrapped |
web_search | Live DuckDuckGo search → top snippets | output sanitized + <untrusted> |
metis_verify | Metis cognition + verification envelope | returns answer + verify_score / verified gate |
Why a gateway (not per-agent tools): generic capabilities are written once; the security core lives in one audited place. Ecosystem-specific capabilities live in their own MCP servers (aimarket-oracle-gateway, aimarket-plugins).
Configure (env)
| var | meaning |
|---|---|
AIMARKET_METIS_URL | Metis verify API base (default https://metis.modelmarket.dev) |
AIMARKET_METIS_KEY | optional bearer for Metis verify |
AIMARKET_SEARCH_URL | DuckDuckGo HTML endpoint override |
AIMARKET_MCP_KEY | HTTP only — bearer auth key |
AIMARKET_MCP_PRODUCTION | HTTP only — 1 requires AIMARKET_MCP_KEY (fail-closed) |
AIMARKET_MCP_RATE | HTTP only — requests/min per key/IP (default 120) |
AIMARKET_MCP_PORT | HTTP only — listen port (default 9090) |
Run (stdio — Glama / Claude Desktop)
pip install -e .
python mcp_stdio_server.py
Claude Desktop (mcpServers entry):
{
"mcpServers": {
"aimarket-mcp": {
"command": "python",
"args": ["mcp_stdio_server.py"],
"cwd": "/path/to/aimarket-mcp"
}
}
}
Or via PyPI script: aimarket-mcp
Run (HTTP — self-host)
pip install -e .
AIMARKET_MCP_KEY=sk-... AIMARKET_MCP_PRODUCTION=1 aimarket-mcp-http # :9090
# or: docker compose up -d (uses Dockerfile.http)
Cursor / Claude (Streamable HTTP)
{
"mcpServers": {
"aimarket-web": {
"type": "streamable-http",
"url": "http://127.0.0.1:9090/mcp",
"headers": {
"Authorization": "Bearer YOUR_AIMARKET_MCP_KEY"
}
}
}
}
Publish on Glama
Listing: glama.ai/mcp/servers/alexar76/aimarket-mcp
Same pattern as aimarket-oracle-gateway (working on Glama): repo-root glama.json + Dockerfile + python mcp_stdio_server.py.
| Field | Value |
|---|---|
| Dockerfile | Dockerfile (from repo — not Glama debian/uv template) |
| Command | python mcp_stdio_server.py |
| Placeholder parameters | {} |
| Pinned SHA | empty (latest) |
Do not use the auto-generated debian:trixie-slim + uv sync + mcp-proxy -- aimarket-mcp template — that was the broken HTTP/ENOENT path.
Consumers
- Metis — enable the preset:
enable_mcp_tools: true mcp_ecosystem_presets: [aimarket-web] - ARGUS — add the server to
argus.config.jsonmcpServers(see that repo).
Test
pip install -e '.[dev]' && pytest -q
Registries
| Registry | Listing |
|---|---|
| Glama | glama.ai/mcp/servers/alexar76/aimarket-mcp |
| Official MCP Registry | io.github.alexar76/aimarket-mcp — server.json + GitHub Actions |
| PyPI | pip install aimarket-mcp |
| GitHub Releases | github.com/alexar76/aimarket-mcp/releases |