+
+
+
+
+
+
+
+
+
+
+
+Website 🚀 contributte.org | Contact 👨🏻💻 f3l1x.io | Twitter 🐦 @contributte +
+ +----- + +# MCP Skeleton + +Example project demonstrating integration of **Model Context Protocol (MCP)** for **Nette Framework** using `contributte/mcp`. + +The MCP integration is based on the upstream documentation: [contributte/mcp docs](https://github.com/contributte/mcp/tree/master/.docs). + + + +## Requirements + +- PHP 8.4+ +- Composer +- Node.js (only for MCP inspector via `npx`) + +## Installation + +```bash +composer install +``` + +## Usage + +This skeleton registers a single MCP server named `default` and uses **attribute auto-discovery** from `app/Domain/Mcp`. + +**Capabilities:** + +- Tools: + - `calculator_add` + - `calculator_multiply` +- Resources: + - `app://config` + - `file://readme` +- Resource templates: + - `app://users/{id}` +- Prompts: + - `code_review` + - `explain_code` + +### Streamable HTTP server + +1. Start inspector: `make inspector` +2. Open the inspector in your browser and connect to `http://localhost:8080/mcp`. + +#### Manual + +1. Start inspector: `make inspector` (or `make mcp-stdio` to auto-run the STDIO server) +2. Open the inspector in your browser and do work. + +## Screenshots + +### STDIO + + + + + +### Streamable HTTP + + + + + + +## Development + +See [how to contribute](https://contributte.org/contributing.html) to this package. + +This package is currently maintaining by these authors. + + +
+
+
+-----
+
+Consider to [support](https://contributte.org/partners.html) **contributte** development team. Also thank you for using this project.
diff --git a/app/Bootstrap.php b/app/Bootstrap.php
new file mode 100644
index 0000000..341631f
--- /dev/null
+++ b/app/Bootstrap.php
@@ -0,0 +1,28 @@
+use(NellaPreset::create(__DIR__))
+ ->boot();
+ }
+
+ public static function run(): void
+ {
+ self::boot()
+ ->createContainer()
+ ->getByType(Application::class)
+ ->run();
+ }
+
+}
diff --git a/app/Domain/Mcp/CalculatorTool.php b/app/Domain/Mcp/CalculatorTool.php
new file mode 100644
index 0000000..cae47ea
--- /dev/null
+++ b/app/Domain/Mcp/CalculatorTool.php
@@ -0,0 +1,22 @@
+ 'default',
+ 'version' => '1.0.0',
+ ], JSON_THROW_ON_ERROR);
+ }
+
+ #[McpResource(
+ uri: 'file://readme',
+ name: 'Readme',
+ description: 'Project readme file',
+ mimeType: 'text/markdown',
+ )]
+ public function getReadme(): string
+ {
+ $readme = __DIR__ . '/../../../README.md';
+
+ if (!is_file($readme)) {
+ return '# README not found';
+ }
+
+ $content = file_get_contents($readme);
+
+ return $content !== false ? $content : '# README not readable';
+ }
+}
+
+
diff --git a/app/Domain/Mcp/UserResourceTemplate.php b/app/Domain/Mcp/UserResourceTemplate.php
new file mode 100644
index 0000000..240f221
--- /dev/null
+++ b/app/Domain/Mcp/UserResourceTemplate.php
@@ -0,0 +1,45 @@
+ [
+ 'id' => 1,
+ 'name' => 'Alice',
+ 'email' => 'alice@example.com',
+ ],
+ 2 => [
+ 'id' => 2,
+ 'name' => 'Bob',
+ 'email' => 'bob@example.com',
+ ],
+ ];
+
+ $user = $users[$userId] ?? null;
+ if ($user === null) {
+ throw new ResourceReadException(sprintf('User "%d" not found.', $userId));
+ }
+
+ return $user;
+ }
+}
+
diff --git a/app/Model/Exception/LogicalException.php b/app/Model/Exception/LogicalException.php
new file mode 100644
index 0000000..28a286a
--- /dev/null
+++ b/app/Model/Exception/LogicalException.php
@@ -0,0 +1,10 @@
+/
+ This project demonstrates Model Context Protocol (MCP) integration for Nette using contributte/mcp.
+
php bin/console mcp:server --server={$serverName}make mcp-stdio/mcp — MCP server endpoint (SSE transport)/mcp?debug=1 — MCP server endpoint with debug mode enabled{$t}{$r}{$p}