kinetis / mcp-docs
A standalone Model Context Protocol server exposing the Kinetis documentation over stdio: one tool that returns a bounded line window of a page, which is how a page is read, and the same pages whole as MCP resources. Framework-agnostic: it depends on kinetis/mcp-protocol alone and contributes no app
Requires
- php: ^8.4
- kinetis/mcp-protocol: ^1.0.0
- symfony/http-client: ^8.1.4
- symfony/http-client-contracts: ^3.7.1
Requires (Dev)
- infection/infection: ^0.35.0
- phpstan/phpstan: ^2.2.8
- phpunit/phpunit: ^13.3.3
- vimeo/psalm: ^6.17
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
kinetis/mcp-docs
The Kinetis documentation, as an MCP server
Part of Kinetis, a non-blocking PHP framework for API-first applications, developed in the kinetis-dev/kinetis monorepo.
A Model Context Protocol server that
serves every page of the Kinetis documentation: one tool that returns a
bounded line window of a page, and the same pages whole as resources — so
an agent working in any codebase can read the framework's own docs
instead of answering from training data. It is framework-agnostic: the
only Kinetis package it depends on is kinetis/mcp-protocol, which is
PHP-only and registers nothing, and the pages are fetched as published
markdown from the monorepo's main branch.
For a server that exposes your own application's tools and resources,
install kinetis/mcp instead.
Setup
One command installs the server into its own directory and registers it with Claude Code:
curl -fsSL https://raw.githubusercontent.com/kinetis-dev/kinetis/main/packages/mcp-docs/setup.sh | bash
Pass codex to register it with Codex instead:
curl -fsSL https://raw.githubusercontent.com/kinetis-dev/kinetis/main/packages/mcp-docs/setup.sh | bash -s codex
It needs a running Docker daemon and the client's own CLI on your PATH —
no PHP or Composer of your own, and no sudo.
Running it directly
composer require kinetis/mcp-docs php vendor/bin/kinetis-mcp-docs
The binary speaks JSON-RPC over stdin and stdout, one message per line:
initialize, notifications/initialized, ping, tools/list,
tools/call, resources/list and resources/read, on MCP
2025-06-18. Register that command with any MCP client that launches a
server as a subprocess. Read kinetis://docs/agent-workflow first — the
entry point and routing table for the rest of the catalogue.
Read a page by calling the kinetis_read_doc tool with its URI from
line 1: at most 200 lines and 32 KiB per call, continuing from the
endLine each result reports while what you came for is unresolved.
Read the same URI as a resource when the whole page is what you need.
Requires PHP 8.4+. Full documentation: kinetis.dev/docs/mcp-docs.html.
License
MIT — see LICENSE.