{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_a4kv48xfp83n","handle":"mcp-server-kit","url":"https://wellknown.network/agents/mcp-server-kit","links":{"self":"https://wellknown.network/agents/mcp-server-kit/record.json","html":"https://wellknown.network/agents/mcp-server-kit","markdown":"https://wellknown.network/agents/mcp-server-kit/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-kit","status":"https://wellknown.network/api/v1/agents/mcp-server-kit/status","claim":"https://wellknown.network/agents/mcp-server-kit/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-kit/claim.json","badge":"https://wellknown.network/agents/mcp-server-kit/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-kit/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-kit/tools"},"ard":{"identifier":"urn:air::server:mcp-server-kit","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-kit","summary":"Shared plumbing for FastMCP servers: bearer auth, off-event-loop sync tools with per-call logging, stdio/HTTP serving, and a liveness probe","description":"# mcp-server-kit\n\nShared plumbing for Python MCP servers built on the official SDK's FastMCP\n(`mcp.server.fastmcp`). It covers the parts every server ends up copying:\n\n| Module | What it does |\n|---|---|\n| `offload_sync_tools` | Registers each **sync** tool as an async wrapper that runs the body in a worker thread, so one blocking upstream call can't freeze every other request. The SDK runs sync handlers inline on the event loop. Signatures, and so input schemas, are unchanged. Every call, sync or async, logs one `tool=… outcome=… duration_ms=… rss_mib=…` line. |\n| `BearerAuthMiddleware` | Pure ASGI bearer-token gate (timing-safe compare, streaming-safe). Only `/.well-known/` discovery paths are exempt, matched by prefix, never by substring. |\n| `serve` | `--stdio` runs stdio. Otherwise it serves Streamable HTTP at `/mcp` behind the bearer gate, and **refuses to start without a token**. |\n| `healthcheck.probe` | A liveness probe for containers: a full HTTP round-trip to `/mcp`, where the 401 counts as alive. Pair it with restart-on-unhealthy so a wedged loop heals itself. |\n| `files` | Collision-safe staging for a directory several servers share: bare names only, never overwrite (`-2`, `-3`, … before the extension, `O_CREAT\\|O_EXCL`), `sha256` of every transfer. `atomic_create` writes bytes; `exclusive_open` hands a streaming writer the fd. `list_files` / `purge_one` / `purge_older` (0.1.1) are the bodies of the matching housekeeping tools: listing with sha256 and `<scheme>:<name>` references, delete by bare name, age-based purge with dry run. |\n| `pdf` (extra `[pdf]`) | PDF text extraction (pdfplumber text / layout / tables), page rendering (pypdfium2), and OCR through an [xberg](https://github.com/xberg-io/xberg) server (tesseract, or a vision model for hard pages). Configured by `XBERG_*` env vars; the PDF libraries load lazily. |\n\n## Install\n\n```bash\nuv add mcp-server-kit        # or: pip install mcp-server-kit\n```\n\nIt pins `mcp>=1,<2`, so the SDK range lives i…","publisher":null,"homepage":"https://github.com/snickery/mcp-server-kit","repository":"https://github.com/snickery/mcp-server-kit","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["auth","fastmcp","mcp","model-context-protocol","server"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-kit","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["dev","security"],"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":"mcp-server-kit","registry":"pypi","observedAt":"2026-11-03T15:23:24.162Z","publishedAt":"2026-10-25T11:42:15.438773Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-kit","url":"https://pypi.org/project/mcp-server-kit/","firstSeenAt":"2026-10-28T13:23:55.711Z","fetchedAt":"2026-11-03T15:22:44.308Z","normalizedAt":"2026-11-03T15:22:44.308Z"}]},"firstSeenAt":"2026-10-28T13:23:55.711Z","updatedAt":"2026-11-03T15:23:24.162Z"}