KC.SolutionServer 1.0.12

SolutionServer

UNDER ACTIVE DEVELOPMENT -- FEATURES ARE BEING ADDED DAILY - UPDATE OFTEN

SolutionServer is a production‑oriented local Model Context Protocol (MCP) server written in C# targeting .NET 10. It provides a read‑only API for inspecting a local workspace – listing projects, enumerating files, and reading file contents – which can be consumed by VS Code, Visual Studio, or any MCP‑compatible client.

Features

• Workspace summary – absolute root path, solution file (if any), and discovered projects.
• Project discovery – supports *.csproj, *.fsproj, *.vbproj.
• File enumeration – walks the workspace while respecting ignored directories (bin, obj, .git, etc.).
• Bounded file reads – safe line‑range reads (max 400 lines).
• MCP integration – ready‑to‑use .mcp manifest and VS Code/Visual Studio configuration samples.

Getting Started

The server can be installed instantly via the Add Mcp Server command in VS Code Just enter "KC.SolutionServer" for the package name. Just hit enter on the prompts and the server will be installed and running in the background. Then in the tools menu make sure the server is selected for use. Using the server in this manner the server is not installed globally and is only available to the current user. NOTE: This server is designed to restrict usage to the workspace only, installing globally allows commands to be run globally.

## Architecture

The server consists of three main parts:

1. **`Program.cs`** – sets up a generic host, registers logging, the `WorkspaceService`, and the MCP tools.
2. **`WorkspaceService`** – core logic for discovering the workspace, projects, and files. It enforces the `SOLUTION_SERVER_ROOT` environment variable to sandbox access.
3. **MCP tools** – thin wrappers (`WorkspaceTools`) exposing the service methods to the MCP protocol.

## Tools

The tools are designed for deterministic read‑only access to the workspace.