McpEndpointsTools 1.0.0-alpha

MCP Endpoints Tools

Library for ASP.NET Core Web API, which automatically turns each controller method into a tool for the MCP server.

Under the hood, MCP Endpoints Tools uses the Model Context Protocol C# SDK for working with tools.

Description

MCP Endpoints Tools scans the application build, finds all controllers and their public methods marked with HTTP attributes, and registers them as Model Context Protocol (MCP) tools. In this case, XML comments from the assembly are used to fill in the description (summary) of the tools.

Features

• Automatic registration of all controller methods as MCP tools and resources
• Support for method exclusion via the [McpIgnore] attribute
• Автоматическое добавление описания инструмента из XML-комментариев сборки через XmlCommentsProvider
• Flexible configuration via ServerOptions (path, name, description, version, XML path)
• Easy integration into 'IServiceCollectionandIEndpointRouteBuilder' via extensions ServiceCollectionExtensions and EndpointRouteBuilderExtensions

Installation

1. Add the McpEndpointsTools project to your solution or connect via NuGet (if there is a package):

   dotnet add package McpEndpointsTools
   

2. In the file Program.cs (or Startup.cs), register the services and mapping:

   using McpEndpointsServer.Extensions;
   
   var builder = WebApplication.CreateBuilder(args);
   
   // MCP Server registration and controller scanning
   builder.Services.AddMcpEndpointsServer(opts =>
   {
          opts.PipelineEndpoint = "/mcp"; // path for the HTTP pipeline
          opts.ServerName = "My MCP Server"; // server name
          opts.ServerDescription = "API for MCP"; // description
          opts.ServerVersion = "1.2.3"; // version
          opts.XmlCommentsPath = "MyApp.xml "; // path to the XML documentation file
          opts.HostUrl = "https://api.mysite "; // base URL
   });
   

3. Set up routing in the same or another location:

   var app = builder.Build();
   
   app.MapControllers(); // regular controllers
   app.MapMcpEndpointsServer(); // MCP endpoints (HTTP stream & SSE)
   
   app.Run();
   

Attributes

• McpIgnoreAttribute It is placed above the controller method to exclude it from the list of generated MCP tools.
• Authorize Methods and controllers marked with the Authorize attribute will not be added to the tools. In future versions, support for authentication authorization may be added.

License

MIT License. See the LICENSE file for details.