feat(mcp): add mcp server

Directory.Packages.props

@@ -24,7 +24,9 @@
     <PackageVersion Include="OneOf" Version="3.0.271" />
     <PackageVersion Include="OneOf.SourceGenerator" Version="3.0.271" />
     <PackageVersion Include="Polly" Version="8.7.0" />
+    <PackageVersion Include="ModelContextProtocol.AspNetCore" Version="1.4.0" />
     <PackageVersion Include="Refit" Version="13.1.0" />
+    <PackageVersion Include="Refit.HttpClientFactory" Version="13.1.0" />
     <PackageVersion Include="Refitter.MSBuild" Version="2.0.0" />
     <PackageVersion Include="Serilog.AspNetCore" Version="10.0.0" />
     <PackageVersion Include="Serilog.Expressions" Version="5.0.0" />

Integrations/MCP/README.md

@@ -0,0 +1,121 @@
+# ScriptBee MCP Server
+
+This is the official Model Context Protocol (MCP) server for ScriptBee, built using the standard `.NET` MCP SDK.
+It exposes ScriptBee capabilities (project management, context loading, script execution, and analysis) to AI clients like Claude Desktop, Claude Code, GitHub Copilot, or VS Code.
+
+## Running the Server
+
+You can run the server in two modes:
+
+### HTTP Transport
+```bash
+cd src/ScriptBee.MCP
+dotnet run
+```
+The server will start on `http://localhost:5094` (or the configured port) and expose the `/mcp` endpoint for SSE connections.
+
+For clients that support connecting to a remote MCP server natively via a URL (such as GitHub Copilot / VS Code via its MCP extension), you can configure the connection directly in your `mcp.json` like this:
+
+```json
+{
+  "mcpServers": {
+    "scriptbee-mcp-server": {
+      "url": "http://localhost:5094/mcp",
+      "type": "http"
+    }
+  }
+}
+```
+*(Replace `5094` with the actual port the MCP server is running on)*
+
+### Stdio Transport (for IDEs and Claude Desktop)
+```bash
+cd src/ScriptBee.MCP
+dotnet run -- --stdio
+```
+
+## Configuring Client Applications
+
+### VS Code, Claude Code, or GitHub Copilot
+
+You can add this server to your local tools using an `mcp.json` configuration file (or the IDE's corresponding settings file).
+
+Create or update your `mcp.json` with the following. You can either point to the compiled executable (recommended) or run it from source using `dotnet run`.
+
+**Option 1: Using the compiled executable (Recommended)**
+After building or publishing the project, point directly to the output executable.
+
+```json
+{
+  "mcpServers": {
+    "scriptbee": {
+      "command": "C:/Absolute/Path/To/ScriptBee.MCP.exe",
+      "args": [
+        "--stdio"
+      ]
+    }
+  }
+}
+```
+
+**Option 2: Running from source (Development)**
+```json
+{
+  "mcpServers": {
+    "scriptbee": {
+      "command": "dotnet",
+      "args": [
+        "run",
+        "--project",
+        "C:/Absolute/Path/To/ScriptBee.MCP.csproj",
+        "--",
+        "--stdio"
+      ]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add the following to your Claude Desktop `claude_desktop_config.json` file (usually located at `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
+
+```json
+{
+  "mcpServers": {
+    "scriptbee": {
+      "command": "C:/Absolute/Path/To/ScriptBee.MCP.exe",
+      "args": [
+        "--stdio"
+      ]
+    }
+  }
+}
+```
+
+## Exposed Capabilities
+
+### Tools
+- **ProjectTools**: Manage projects (`GetProjects`, `CreateProject`, etc.)
+- **ScriptTools**: Manage scripts and project files
+- **InstanceTools**: Manage execution instances
+- **ContextTools**: Load and link data contexts, search the context graph
+- **AnalysisTools**: Trigger script analyses and fetch results/logs
+
+### Resources
+- **Script Source Code**: Read script contents (`scriptbee://projects/{projectId}/scripts/{scriptId}/content`)
+- **Analysis Console Output**: Read analysis logs (`scriptbee://projects/{projectId}/analyses/{analysisId}/console`)
+- **Instance Context**: View the loaded context graph summary (`scriptbee://projects/{projectId}/instances/{instanceId}/context`)
+
+### Prompts
+- **explore-project**: Guides the AI to give an overview of a project.
+- **load-and-link-context**: Guides the AI through the context ingestion workflow.
+- **run-analysis**: A workflow for the AI to run an analysis and monitor it until completion.
+
+## Configuration
+
+The ScriptBee MCP server can be configured via command-line arguments or environment variables. Below are the available options:
+
+| Option        | Description                           | Default                 |
+| ------------- | ------------------------------------- | ----------------------- |
+| GatewayApiUrl | The URL of the ScriptBee Gateway API. | `http://localhost:5117` |