@kozmos-tech/inhalt 0.1.0

package/README.md

@@ -0,0 +1,54 @@
+# @kozmos-tech/inhalt
+
+MCP bridge for [Inhalt](https://inhalt.tech) — the CMS your AI tools can run.
+
+Inhalt's MCP server is hosted and remote. This package is a tiny launcher that
+bridges any stdio MCP client to the hosted endpoint, so clients that only speak
+stdio (or launch servers via `npx`) can connect with one config block.
+
+## Usage
+
+Add Inhalt to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "inhalt": {
+      "command": "npx",
+      "args": ["-y", "@kozmos-tech/inhalt"]
+    }
+  }
+}
+```
+
+That's it. On first run the bridge opens a browser to sign in (OAuth); after that
+your session is cached. The client then sees Inhalt's content tools — read and
+query the schema, list and get entries, create, patch, publish, and delete.
+
+## Authentication
+
+- **OAuth (default):** the first run opens a browser to authorize the connection.
+- **API key:** for scripts and headless setups, mint a scoped key in the Inhalt
+  dashboard and pass it as a bearer token via your client's header settings.
+
+## Self-hosting
+
+Point the bridge at your own Inhalt instance with an environment variable:
+
+```json
+{
+  "mcpServers": {
+    "inhalt": {
+      "command": "npx",
+      "args": ["-y", "@kozmos-tech/inhalt"],
+      "env": { "INHALT_MCP_URL": "https://cms.example.com/mcp" }
+    }
+  }
+}
+```
+
+`INHALT_MCP_URL` defaults to `https://inhalt.tech/mcp`.
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+// Thin stdio -> remote bridge for the Inhalt MCP server.
+//
+// Inhalt's MCP server is remote (Streamable HTTP at https://inhalt.tech/mcp,
+// OAuth + API-key auth). This launcher execs the mcp-remote CLI against that
+// endpoint so any stdio-only client can connect via `npx @kozmos-tech/inhalt`.
+// Self-hosters can point at their own instance with INHALT_MCP_URL.
+import { spawn } from "node:child_process"
+import { createRequire } from "node:module"
+
+const require = createRequire(import.meta.url)
+const url = process.env.INHALT_MCP_URL ?? "https://inhalt.tech/mcp"
+
+// Resolve mcp-remote's CLI entry from its own package.json "bin" so we don't
+// hardcode a dist path that could move between releases.
+const pkg = require("mcp-remote/package.json")
+const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin["mcp-remote"]
+const cli = require.resolve(`mcp-remote/${binRel}`)
+
+const child = spawn(process.execPath, [cli, url, ...process.argv.slice(2)], { stdio: "inherit" })
+child.on("exit", (code) => process.exit(code ?? 0))

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@kozmos-tech/inhalt",
+  "version": "0.1.0",
+  "description": "MCP bridge for Inhalt — the CMS your AI tools can run. Connects any stdio MCP client to the hosted Inhalt server.",
+  "mcpName": "io.github.kozmos-tech/inhalt",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "inhalt-mcp": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "cms",
+    "inhalt"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kozmos-tech/inhalt.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://inhalt.tech",
+  "bugs": "https://github.com/kozmos-tech/inhalt/issues",
+  "dependencies": {
+    "mcp-remote": "^0.1.38"
+  }
+}