Een minimale MCP-server maken met C# en publiceren naar NuGet

• .NET 10.0 SDK
• Visual Studio 2022 of hoger
• GitHub-copiloot
• NuGet.org-account

• .NET 10.0 SDK
• Visual Studio Code (optioneel)
• C# Dev Kit-extensie
• GitHub Copilot-extensie voor Visual Studio Code
• NuGet.org-account

• .NET 10.0 SDK
• Visual Studio Code (optioneel)
• Visual Studio (optioneel)
• GitHub Copilot / GitHub Copilot-extensie voor Visual Studio Code
• NuGet.org-account

1. Installeer in een terminalvenster de MCP Server-sjabloon:

   dotnet new install Microsoft.McpServer.ProjectTemplates
   

   Opmerking

   .NET 10.0 SDK of een latere versie is vereist om te installeren Microsoft.McpServer.ProjectTemplates.

2. Open Visual Studio en selecteer Een nieuw project maken in het startvenster (of selecteer Bestand>nieuw>project/oplossing in Visual Studio).

   

3. Selecteer in het venster Een nieuw project makenC# in de lijst Taal en AI in de lijst Alle projecttypen . Nadat u de taal- en projecttypefilters hebt toegepast, selecteert u de sjabloon MCP Server-app en selecteert u vervolgens Volgende.

   

4. Voer in het venster Uw nieuwe project configurerenMyMcpServer in het veld Projectnaam in. Klik vervolgens op Volgende.

   

5. In het venster Aanvullende informatie kunt u de volgende opties configureren:

   • Framework: Selecteer het doel .NET Framework.
   • MCP-servertransporttype: kies tussen het maken van een lokale (stdio) of een externe (http) MCP-server.
   • Systeemeigen AOT (Ahead-Of-Time) publiceren inschakelen: ervoor zorgen dat uw MCP-server op zichzelf staat en wordt gecompileerd naar systeemeigen code. Zie de native AOT-implementatiehandleiding voor meer informatie.
   • Zelfstandig publiceren inschakelen: ervoor zorgen dat uw MCP-server wordt gepubliceerd als zelfstandig uitvoerbaar bestand. Zie de sectie Zelfstandige implementatie van de publicatiehandleiding voor .NET-toepassingen voor meer informatie.

   Kies de gewenste opties of behoud de standaardopties en selecteer vervolgens Maken.

   

   Visual Studio opent uw nieuwe project.

6. Werk het <PackageId> bestand bij zodat het .csproj uniek is op NuGet.org, bijvoorbeeld <NuGet.org username>.SampleMcpServer.

1. Installeer in een terminalvenster de MCP Server-sjabloon:

   dotnet new install Microsoft.McpServer.ProjectTemplates
   

   Opmerking

   .NET 10.0 SDK of hoger is vereist om te installeren Microsoft.McpServer.ProjectTemplates.

2. Open Visual Studio Code.

3. Ga naar de verkennerweergave en selecteer .NET-project maken. U kunt ook het opdrachtenpalet openen met Ctrl+Shift+P (Command+Shift+P in MacOS) en vervolgens '.NET' typen om de opdracht .NET: New Project te zoeken en te selecteren.

   Met deze actie wordt een vervolgkeuzelijst met .NET-projecten weergegeven.

   

4. Nadat u de opdracht hebt geselecteerd, gebruikt u de zoekbalk in het opdrachtpalet of schuift u omlaag om de sjabloon van de MCP Server-app te zoeken.

   

5. Selecteer de locatie waar u het nieuwe project wilt maken.

6. Geef uw nieuwe project een naam, MyMCPServer. Druk op Enter.

7. Selecteer de bestandsindeling van uw oplossing (.sln of .slnx).

8. Selecteer Sjabloonopties. Hier kunt u de volgende opties configureren:

   • Framework: Selecteer het doel .NET Framework.
   • MCP-servertransporttype: kies tussen het maken van een lokale (stdio) of een externe (http) MCP-server.
   • Systeemeigen AOT (Ahead-Of-Time) publiceren inschakelen: ervoor zorgen dat uw MCP-server op zichzelf staat en wordt gecompileerd naar systeemeigen code. Zie de native AOT-implementatiehandleiding voor meer informatie.
   • Zelfstandig publiceren inschakelen: ervoor zorgen dat uw MCP-server wordt gepubliceerd als zelfstandig uitvoerbaar bestand. Zie de sectie Zelfstandige implementatie van de publicatiehandleiding voor .NET-toepassingen voor meer informatie.

   

   Kies de gewenste opties of behoud de standaardopties en selecteer Vervolgens Project maken.

   VS Code opent uw nieuwe project.

9. Werk het <PackageId> bestand bij zodat het .csproj uniek is op NuGet.org, bijvoorbeeld <NuGet.org username>.SampleMcpServer.

1. Maak een nieuwe MCP-server-app met de dotnet new mcpserver opdracht:

   dotnet new mcpserver -n SampleMcpServer
   

   Met deze opdracht wordt standaard een zelfstandig hulpprogrammapakket gemaakt dat is gericht op alle meest voorkomende platforms waarop .NET wordt ondersteund. Als u meer opties wilt zien, gebruikt u dotnet new mcpserver --help.

   Met behulp van de dotnet new mcpserver --help opdracht krijgt u verschillende sjabloonopties die u kunt toevoegen bij het maken van een nieuwe MCP-server:

   • Framework: Selecteer het doel .NET Framework.
   • MCP-servertransporttype: kies tussen het maken van een lokale (stdio) of een externe (http) MCP-server.
   • Systeemeigen AOT (Ahead-Of-Time) publiceren inschakelen: ervoor zorgen dat uw MCP-server op zichzelf staat en wordt gecompileerd naar systeemeigen code. Zie de native AOT-implementatiehandleiding voor meer informatie.
   • Zelfstandig publiceren inschakelen: ervoor zorgen dat uw MCP-server wordt gepubliceerd als zelfstandig uitvoerbaar bestand. Zie de sectie Zelfstandige implementatie van de publicatiehandleiding voor .NET-toepassingen voor meer informatie.

   

2. Ga naar de SampleMcpServer directory.

   cd SampleMcpServer
   

3. Bouw het project:

   dotnet build
   

4. Werk het <PackageId> bestand bij zodat het .csproj uniek is op NuGet.org, bijvoorbeeld <NuGet.org username>.SampleMcpServer.

Configureer GitHub Copilot voor Visual Studio om uw aangepaste MCP-server te gebruiken.

1. Selecteer in Visual Studio het GitHub Copilot-pictogram in de rechterbovenhoek en selecteer Chatvenster openen.

2. Klik in het GitHub Copilot Chat-venster op het Selecteer Tools moersleutelpictogram, gevolgd door het pluspictogram in de rechterbovenhoek.

   

3. Voer in het dialoogvenster Aangepaste MCP-server toevoegen de volgende gegevens in:

   • Bestemming: kies het bereik van waar uw MCP-server is geconfigureerd:
     • Oplossing : de MCP-server is alleen beschikbaar in de actieve oplossing.
     • Globaal : de MCP-server is beschikbaar voor alle oplossingen.
   • Server-id: de unieke naam/id voor uw MCP-server.
   • Type: Het transporttype van uw MCP-server (stdio of HTTP).
   • Opdracht (alleen stdio-transport): de opdracht voor het uitvoeren van uw stdio MCP-server (dat wil zeggen, dotnet run --project [relative path to .csproj file])
   • URL (alleen HTTP-transport): het adres van uw HTTP MCP-server
   • Omgevingsvariabelen (optioneel)

   

4. Selecteer Opslaan. Er wordt een .mcp.json bestand toegevoegd aan de opgegeven bestemming.

Stdio Transport .mcp.json

Voeg het relatieve pad toe aan uw .csproj-bestand onder het veld "args".

{
  "inputs": [],
  "servers": {
    "MyMcpServer": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<relative-path-to-project-file>"
      ]
    }
  }
}

HTTP-transport .mcp.json

{
 "inputs": [],
  "servers": {
    "MyMCPServer": {
      "url": "http://localhost:6278",
      "type": "http",
      "headers": {}
    }
  }
}

Configureer GitHub Copilot voor Visual Studio Code om uw aangepaste MCP-server te gebruiken, via het OPDRACHTENpalet van VS Code of handmatig.

Configuratie van opdrachtpalet

1. Open het opdrachtenpalet met Ctrl+Shift+P (Command+Shift+P in macOS). Zoek 'mcp' om de MCP: Add Server opdracht te vinden.

2. Selecteer het type MCP-server dat u wilt toevoegen (meestal het transporttype dat u tijdens het maken van het project hebt geselecteerd).

   

3. Als u een stdio MCP-server toevoegt, voert u een opdracht en optionele argumenten in. Gebruik dotnet run --projectvoor dit voorbeeld .

   Als u een HTTP MCP-server toevoegt, voert u de localhost of het webadres in.

4. Voer een unieke server-id in (bijvoorbeeld: 'MyMCPServer').

5. Selecteer een configuratiedoel:

   • Globaal: maak de MCP-server beschikbaar in alle werkruimten. Het gegenereerde mcp.json bestand wordt weergegeven onder de algemene gebruikersconfiguratie.

   • Werkruimte: maak de MCP-server alleen beschikbaar vanuit de huidige werkruimte. Het gegenereerde mcp.json bestand wordt weergegeven onder de .vscode map in uw werkruimte.

   

6. Nadat u de vorige stappen hebt voltooid, wordt er een .mcp.json bestand gemaakt op de locatie die is opgegeven door het configuratiedoel.

Stdio Transport mcp.json

Voeg het relatieve pad toe aan uw .csproj-bestand onder het veld "args".

{
  "servers": {
    "MyMcpServer": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<relative-path-to-project-file>"
      ]
    }
  }
}

HTTP-transport mcp.json

{
  "servers": {
    "MyMCPServer": {
      "url": "http://localhost:6278",
      "type": "http"
    }
  },
  "inputs": []
}

Handmatige configuratie

1. Maak een .vscode map in de hoofdmap van uw project.

2. Voeg een mcp.json bestand toe aan de .vscode map met de volgende inhoud:

   {
     "servers": {
       "SampleMcpServer": {
         "type": "stdio",
         "command": "dotnet",
         "args": [
           "run",
           "--project",
           "<relative-path-to-project-file>"
         ]
       }
     }
   }
   

   Opmerking

   VS Code voert MCP-servers uit vanuit de hoofdmap van de werkruimte. De <relative-path-to-project-file> tijdelijke aanduiding moet verwijzen naar het .NET-projectbestand. De waarde voor deze SampleMcpServer-app zou bijvoorbeeld zijn SampleMcpServer.csproj.

3. Sla het bestand op.

De MCP-serversjabloon bevat een tool, get_random_number, die u kunt gebruiken voor testen en als beginpunt voor ontwikkeling.

1. Open GitHub Copilot-chat in Visual Studio en schakel over naar de agentmodus .

2. Selecteer het pictogram Selecteer hulpprogramma's om te verifiëren dat uw MyMCPServer beschikbaar is, zoals vermeld bij het voorbeeldhulpprogramma.

   

3. Voer een prompt in om het hulpprogramma get_random_number uit te voeren:

   Give me a random number between 1 and 100.
   

4. GitHub Copilot vraagt toestemming om het hulpprogramma get_random_number uit te voeren voor uw prompt. Selecteer Doorgaan of gebruik de pijl om een specifieker gedrag te selecteren:

   • De huidige sessie voert de bewerking altijd uit in de huidige Sessie van de GitHub Copilot-agentmodus.
   • De huidige oplossing voert altijd de opdracht uit voor de huidige Visual Studio-oplossing.
   • Sta altijd toe dat de bewerking altijd wordt uitgevoerd voor elke GitHub Copilot Agent Mode-sessie.

5. Controleer of de server reageert met een willekeurig getal:

   Your random number is 42.
   

De MCP-serversjabloon bevat een tool, get_random_number, die u kunt gebruiken voor testen en als beginpunt voor ontwikkeling.

1. Open GitHub Copilot-chat in VS Code en schakel over naar de agentmodus .

2. Selecteer het pictogram Hulpprogramma's om te controleren of uw MyMCPServer beschikbaar is met het vermelde voorbeeldhulpprogramma.

   

3. Voer een prompt in om het hulpprogramma get_random_number uit te voeren:

   Give me a random number between 1 and 100.
   

4. GitHub Copilot vraagt toestemming om het hulpprogramma get_random_number uit te voeren voor uw prompt. Selecteer Doorgaan of gebruik de pijl om een specifieker gedrag te selecteren:

   • De huidige sessie voert de bewerking altijd uit in de huidige Sessie van de GitHub Copilot-agentmodus.
   • De huidige werkruimte voert altijd de opdracht uit voor de huidige VS Code-werkruimte.
   • Sta altijd toe dat de bewerking altijd wordt uitgevoerd voor elke GitHub Copilot Agent Mode-sessie.

5. Controleer of de server reageert met een willekeurig getal:

   Your random number is 42.