MCPSharp MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Attributs [McpTool] / [McpResource] / [McpParameter] — API au niveau de la méthode
JSON-RPC automatique, validation des paramètres, conversion de type
Extraction de documents XML → descriptions des outils
Intégrations avec Microsoft.Extensions.AI et Semantic Kernel
Enregistrement d'outils dynamiques pour les outils définis au moment de l'exécution
Livré également un client C# MCP pour appeler d'autres serveurs MCP

Démo en direct

Aperçu en pratique

mcpsharp.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcpsharp": {
      "command": "dotnet",
      "args": [
        "add",
        "package",
        "MCPSharp"
      ],
      "_inferred": false
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcpsharp": {
      "command": "dotnet",
      "args": [
        "add",
        "package",
        "MCPSharp"
      ],
      "_inferred": false
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcpsharp": {
      "command": "dotnet",
      "args": [
        "add",
        "package",
        "MCPSharp"
      ],
      "_inferred": false
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcpsharp": {
      "command": "dotnet",
      "args": [
        "add",
        "package",
        "MCPSharp"
      ],
      "_inferred": false
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcpsharp",
      "command": "dotnet",
      "args": [
        "add",
        "package",
        "MCPSharp"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcpsharp": {
      "command": {
        "path": "dotnet",
        "args": [
          "add",
          "package",
          "MCPSharp"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add mcpsharp -- dotnet add package MCPSharp

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : MCPSharp

Exposer les services C# existants en tant qu'outils MCP

👤 Boutiques .NET avec des bibliothèques internes qu'ils souhaitent que les agents IA appellent ⏱ ~30 min intermediate

Quand l'utiliser : Vous disposez d’une bibliothèque métier fonctionnelle en C# et devez la rendre accessible aux agents.

Prérequis

SDK .NET 8+ — https://dotnet.microsoft.com/download
Forfait MCPSharp — dotnet ajouter le package MCPSharp

Déroulement

Méthodes de décoration

Ajoutez [McpTool] aux méthodes publiques que je souhaite exposer dans mon OrdersService. Conservez les signatures ; laissez MCPSharp valider.✓ Copié

→ Attributs appliqués, documents XML utilisés comme descriptions
Démarrer le serveur

Ajoutez un point d'entrée Program.cs qui appelle MCPServer.StartAsync("orders", "1.0.0").✓ Copié

→ Fonctionne via dotnet ; Les clients MCP peuvent découvrir des outils
Connectez-vous à Claude Desktop

Émettez un extrait de code claude_desktop_config.json qui lance mon binaire dotnet.✓ Copié

→ Bloc de configuration avec command=dotnet args=[run --project, path]

Résultat : Un serveur MCP alimenté par vos services C#, avec peu de nouveau code.

Pièges

Rendre de gros objets sans les façonner — Renvoyez les DTO - ne sérialisez pas les entités EF avec des propriétés de navigation, vous ferez exploser les réponses

Combiner avec : fastmcp

Utiliser les outils MCP à partir d'un agent Semantic Kernel

👤 Agents de création d'équipes avec Microsoft Semantic Kernel ⏱ ~45 min intermediate

Quand l'utiliser : Vous êtes sur SK et souhaitez utiliser les outils d'un serveur MCP externe.

Déroulement

Ajouter le client

Ajoutez le client de MCPSharp et enregistrez le serveur distant en tant que plugin SK.✓ Copié

→ Les outils apparaissent dans le plan SK
Appel depuis une fonction

Afficher une fonction de chat qui appelle l'un des outils distants lorsque l'utilisateur le demande.✓ Copié

→ Aller-retour : invite → SK sélectionne l'outil → appel MCP → résultat en réponse

Résultat : Votre application SK peut consommer proprement n'importe quel serveur MCP.

Enregistrez les outils au moment de l'exécution à partir d'un dossier de plugin

👤 Les équipes expédient des systèmes de plugins ou des produits low-code ⏱ ~60 min advanced

Quand l'utiliser : Les utilisateurs déposent de nouvelles définitions d'outils et vous souhaitez qu'elles soient disponibles sans redéploiement.

Déroulement

Scanner le dossier

Écrivez un chargeur qui reflète chaque .dll et enregistre les méthodes [McpTool] de manière dynamique.✓ Copié

→ Les outils apparaissent sans modifier les listes codées en dur
Rechargez à chaud en toute sécurité

Ajoutez l’isolation AssemblyLoadContext afin que les rechargements ne fuient pas.✓ Copié

→ Anciens assemblages déchargés entre les rechargements

Résultat : Ensemble d'outils enfichables avec cycle de vie d'assemblage approprié.

Pièges

Fuite d'assemblages avec contexte de chargement par défaut — Utilisez AssemblyLoadContext collectable pour les rechargements isolés

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mcpsharp + fastmcp

Comparez la création de serveur .NET et Python MCP

Portez mes outils Python FastMCP vers MCPSharp pour la pile .NET existante.✓ Copié

mcpsharp + csharp-sdk

Package SDK officiel vs package communautaire : choisissez ce qui vous convient

Comparez MCPSharp et le csharp-sdk officiel pour mes besoins.✓ Copié

mcpsharp + azure-ai-gateway

Placez le serveur C# MCP derrière les stratégies de passerelle Azure AI

Présentez mon serveur MCPSharp avec la passerelle Azure AI pour les limites d'authentification/taux.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler
[McpTool]	C# method signature	Sur chaque méthode que vous souhaitez qu'un agent appelle
[McpResource]	C# member	Lorsque vous souhaitez exposer des ressources lisibles (fichiers/données) et non des outils
[McpParameter]	method parameter	Marquez les paramètres requis et donnez les descriptions des paramètres
MCPServer.StartAsync	name, version	Démarrez le serveur via stdio (ou transport configuré)
MCPClient	server address	Depuis C# pour parler à un autre serveur MCP

Coût et limites

Coût d'exécution

Quota d'API: Aucun — c'est une bibliothèque
Tokens par appel: Cela dépend de vos outils ; la bibliothèque elle-même est petite
Monétaire: Gratuit (OSS de style MIT)
Astuce: Façonnez intentionnellement les DTO de réponse : les gros blobs JSON gonflent à la fois les jetons et la latence.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Quelle que soit l'utilisation de vos services (configuration ASP.NET, KeyVault, etc.). MCPSharp ne possède pas d'informations d'identification.

Sortie de données : Dépend du transport (stdio local ; HTTP/remote si configuré).

[McpTool] expose tout ce que fait la méthode. Examinez chaque méthode annotée comme s’il s’agissait d’une API publique – pas d’outils accidentels de « tout supprimer ».

Dépannage

Erreurs courantes et correctifs

Outil non découvert par le client

Confirmez que la méthode est publique, qu'elle contient [McpTool] et que le nom de l'attribut correspond à ce que vous l'appelez. Vérifiez également le nom du serveur transmis à StartAsync.

Vérifier : MCPServer.ListTools() at startup

Exception de sérialisation au retour

Renvoyez un POCO/DTO ; évitez les entités et les types EF chargés paresseusement avec des références cycliques.

Vérifier : Unit test serialization with System.Text.Json

Le noyau sémantique ne voit pas les outils

Enregistrez explicitement le plugin MCP et confirmez que le constructeur du noyau en est conscient ; certaines versions SK nécessitent une importation explicite.

Vérifier : Log plugins at startup

Alternatives

MCPSharp vs autres

Alternative	Quand l'utiliser	Compromis
csharp-sdk (official)	Vous voulez le SDK officiel Anthropic/MCP C#	Ergonomie différente ; surveillez les différences de fonctionnalités
fastmcp	Vous préférez Python	Écosystème différent
mcp-agent	Vous voulez des modèles d'agent basés sur Python, pas seulement une création de serveur	Pas .NET

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills