Metadata-Version: 2.4
Name: kubed-mcp
Version: 0.0.1
Summary: An opinionated platform on top of FastMCP: how an MCP server serves plugins (skills, agents, commands), the protocol details that come with it, and extension points loaded through Python entry points.
License-Expression: MIT
Project-URL: Homepage, https://github.com/kubed-io
Project-URL: Repository, https://github.com/kubed-io/quick-mcp
Project-URL: Issues, https://github.com/kubed-io/quick-mcp/issues
Project-URL: Changelog, https://github.com/kubed-io/quick-mcp/blob/main/CHANGELOG.md
Keywords: mcp,fastmcp,plugins,skills,agent-skills,ai
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp<5,>=4.1.4
Provides-Extra: build
Requires-Dist: setuptools_scm; extra == "build"
Requires-Dist: build; extra == "build"
Requires-Dist: wheel; extra == "build"
Requires-Dist: twine; extra == "build"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-asyncio; extra == "test"
Requires-Dist: ruff; extra == "test"
Dynamic: license-file

# 🧩 kubed-mcp

**An opinionated platform on top of FastMCP.** How an MCP server serves plugins — skills, agents, commands — and the protocol details that come with it, written once and shared. 🧰

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![FastMCP](https://img.shields.io/badge/FastMCP-4-8a2be2)](https://gofastmcp.com/)

> **Pre-release.** This is a skeleton: the repository, its devops and a name on PyPI. There is no code to use yet.

---

## The whole idea, in one breath

Our MCP servers each serve plugins, and each used to settle the same protocol details by hand. `kubed-mcp` is where they are settled once. A server says *what* it serves, in names and config, and the library does *how*.

```
a server's plugins  ──▶  kubed-mcp  ──▶  FastMCP  ──▶  hosts
```

---

## 🧱 What it will be

- **One way of serving plugins.** Skills, agents and commands, the same way every time, whatever put them there.
- **The protocol, handled.** Modes, directory reads and the [Skills extension](https://modelcontextprotocol.io/extensions/skills/overview), where FastMCP has no support of its own yet.
- **Extension points.** Python entry points, found by name, so an implementation can live in another package.

It is built for [mcp-kb](https://github.com/kubed-io/mcp-kb) and [selenium-flow](https://github.com/kubed-io/selenium-flow), and open to anyone serving plugins over MCP.

---

## 📦 Install

```bash
pip install kubed-mcp
```

Import it as `kubed.mcp`. Today that gets you a package with nothing in it.

---

## 🤝 Contributing

[CONTRIBUTING.md](CONTRIBUTING.md) is the loop; [AGENTS.md](AGENTS.md) is for the agents working here. MIT licensed.
