McpServerDotNet

McpServerDotNet is a .NET 10 Model Context Protocol server for local developer automation. It exposes a workspace-aware filesystem surface, MCP resources and prompts, an activity-routing layer for Codex-style workflows, and optional execution, SSH, web, and Ollama-backed local inference tooling.

This is not a generic scaffold anymore. The repository already contains a working stdio MCP host, real tool/resource/prompt routing, safety gates around higher-risk operations, optional local Ollama integration, and setup scripts for clients such as LM Studio and VS Code.

Who this is for

• Developers building or operating local MCP workflows from .NET.
• LM Studio or GitHub Copilot users who want a repo-aware local MCP server.
• Teams that want a Clean Architecture MCP host they can extend with their own tools, resources, prompts, and infrastructure adapters.

Implemented capabilities

Always available

• Stdio MCP host with JSON-RPC lifecycle handling for initialize, ping, shutdown, exit, tools, resources, and prompts.
• Workspace-aware filesystem tools for read, write, append, copy, move, delete, metadata, and directory listing.
• Workspace tools for root switching, project-folder switching, status, and bounded code-review snapshots.
• MCP resources for file text, directory listings, metadata, recursive tree snapshots, and recent workspace changes.
• MCP prompts for file summarization and grounded directory review.
• Activity tools that classify requests and build bounded local-model context packets without calling a model directly.
• Clean Architecture split across Host, Protocol, Application, Infrastructure, Contracts, and Domain projects.

Conditionally enabled

• shell.exec for non-interactive local command execution under an explicit allow/deny policy.
• inference.local_* tools for Ollama-backed summarization, planning, code review, and completion.
• ssh.execute and ssh.write_text for profile-based remote automation.
• web.fetch_url and web.search for allowlisted outbound web access.

Client integration

• LM Studio installer and diagnostics scripts.
• VS Code user-level MCP config installer.
• Packable dotnet tool host via McpServer.Host.
• Optional Ollama-backed local inference path for summarization, planning, code review, and bounded completion.

Solution layout

Default tool surface

Filesystem

• fs.write_text
• fs.append_text
• fs.read_file
• fs.read_text
• fs.get_metadata
• fs.list_directory
• fs.create_directory
• fs.move_path
• fs.copy_path
• fs.delete_path

Workspace and review

• workspace.set_root
• workspace.open
• workspace.select_folder
• workspace.status
• workspace.inspect

Activity orchestration

• activity.route
• activity.schemas.list
• activity.context.preview
• activity.run

Resources

• file:///workspace/...
• dir:///workspace/...
• filemeta:///workspace/...
• tree:///project
• tree:///workspace
• changes:///project
• `changes:/

... View full README on GitHub