@tesseron/docs-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,114 @@
+Business Source License 1.1
+
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:             Kenny Vaneetvelde
+
+Licensed Work:        Tesseron
+                      The Licensed Work is (c) 2026 Kenny Vaneetvelde.
+
+Additional Use Grant: You may make production use of the Licensed Work,
+                      provided your use does not include offering the
+                      Licensed Work, or a substantial portion of its
+                      functionality, to third parties as a hosted or
+                      managed service.
+
+                      For clarity, permitted uses include (but are not
+                      limited to): embedding the Licensed Work in your
+                      own applications (commercial or otherwise),
+                      internal use within your organization, consulting
+                      engagements that integrate the Licensed Work into
+                      client applications, redistributing modified or
+                      unmodified copies of the Licensed Work, and running
+                      the gateway locally on end-user machines as part
+                      of the user's own tooling.
+
+Change Date:          Four years from the date the Licensed Work is
+                      published. For each release of the Licensed Work,
+                      the Change Date is four years from the publication
+                      date of that release.
+
+Change License:       Apache License, Version 2.0
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first
+publicly available distribution of a specific version of the Licensed Work
+under this License, whichever comes first, the Licensor hereby grants you
+rights under the terms of the Change License, and the rights granted in the
+paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may
+vary for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified
+copy of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in
+this License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to
+all other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License
+   can be included in a program with software provided under GPL Version 2.0
+   or a later version. Licensor may specify additional Change Licenses
+   without limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License,
+   as the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+-----------------------------------------------------------------------------
+
+Notice
+
+The Business Source License (this document, or the "License") is not an
+Open Source license. However, the Licensed Work will eventually be made
+available under an Open Source License, as stated in this License.

package/README.md

@@ -0,0 +1,95 @@
+# @tesseron/docs-mcp
+
+[Tesseron](https://brainblend-ai.github.io/tesseron) documentation as an MCP server. Search and read the full protocol + SDK docs from any MCP-compatible AI client: Claude Code, Claude Desktop, Cursor, Windsurf, Zed, and anything else that speaks the [Model Context Protocol](https://modelcontextprotocol.io).
+
+No network, no vector store, no API keys. The docs snapshot is bundled in the npm package at publish time. Search runs locally with BM25 over in-memory text.
+
+## Why
+
+If you are writing a Tesseron app, your AI assistant should know Tesseron. This server exposes the canonical Tesseron docs as three MCP tools (`list_docs`, `search_docs`, `read_doc`) plus `tesseron-docs://<slug>` resources so the agent can retrieve exact spec text before answering instead of guessing from training data.
+
+## Install
+
+Nothing to install. Use `npx`.
+
+## Configure your AI client
+
+### Claude Code / Claude Desktop
+
+Add to `~/.claude.json` or `~/.config/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "tesseron-docs": {
+      "command": "npx",
+      "args": ["-y", "@tesseron/docs-mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "tesseron-docs": {
+      "command": "npx",
+      "args": ["-y", "@tesseron/docs-mcp"]
+    }
+  }
+}
+```
+
+### Windsurf / Zed / any other MCP client
+
+Point the client at `npx -y @tesseron/docs-mcp`. stdio transport, Node ≥ 20.
+
+## Tools
+
+| Tool | Input | Returns |
+|---|---|---|
+| `list_docs` | `{}` | `{ count, docs: Array<{ slug, title, section, description, related }> }` |
+| `search_docs` | `{ query: string, limit?: number (1-20, default 8) }` | `{ query, count, hits: Array<{ slug, title, description, section, score, snippet }> }` |
+| `read_doc` | `{ slug: string }` | `{ slug, title, description, section, related, body }` (body is full markdown) |
+
+Slug format: `<section>/<basename>` without extension. Examples: `protocol/handshake`, `sdk/typescript/action-builder`, `examples/react-todo`.
+
+## Resources
+
+Each docs page is also exposed as an MCP resource at `tesseron-docs://<slug>`. Clients that prefer the resource surface over tools (Claude Desktop is one) get full listing via `list_resources` and full markdown bodies via `read_resource`.
+
+## Search behaviour
+
+- BM25 index via [minisearch](https://www.npmjs.com/package/minisearch).
+- Fields: `title` (weight 3), `description` (weight 2), `bodyText` (weight 1).
+- Fuzzy matching (`0.15`) and prefix matching are both on.
+- Snippets are ~240 chars centred on the best match, with ellipses added when truncated.
+
+## Dev / local use
+
+Point the server at a local snapshot or set the env var:
+
+```bash
+# Build fresh snapshot from the monorepo docs tree.
+pnpm --filter @tesseron/docs-mcp build:snapshot
+
+# Run from source with a custom snapshot file.
+pnpm --filter @tesseron/docs-mcp start -- --snapshot ./dist/docs-index.json
+
+# Or via env var.
+TESSERON_DOCS_SNAPSHOT=/abs/path/to/docs-index.json npx @tesseron/docs-mcp
+```
+
+The snapshot is rebuilt on every `pnpm build` (via `pnpm build:snapshot && tsup`) and on `prepublishOnly`.
+
+## Versioning
+
+`@tesseron/docs-mcp` versions track the docs snapshot, not the SDK. A new publish means the bundled docs were updated. It is unscoped from the `@tesseron/{core,web,server,react,mcp}` fixed-version bundle so SDK releases do not churn the docs package.
+
+## License
+
+BUSL-1.1. See [LICENSE](./LICENSE).