Add McpServerTool attributes

Author: stuartpa

MssqlMcp/MssqlMcp/Tools/CreateTable.cs

@@ -9,7 +9,11 @@ namespace Mssql.McpServer;
 
 public partial class Tools
 {
-    [McpServerTool, Description("Creates a new table in the SQL Database. Expects a valid CREATE TABLE SQL statement as input.")]
+    [McpServerTool(
+        Title = "Create Table",
+        ReadOnly = false,
+        Destructive = false),
+        Description("Creates a new table in the SQL Database. Expects a valid CREATE TABLE SQL statement as input.")]
     public async Task<DbOperationResult> CreateTable(
         [Description("CREATE TABLE SQL statement")] string sql)
     {

MssqlMcp/MssqlMcp/Tools/DescribeTable.cs

@@ -10,7 +10,12 @@ namespace Mssql.McpServer;
 
 public partial class Tools
 {
-    [McpServerTool, Description("Returns table schema")]
+    [McpServerTool(
+        Title = "Describe Table",
+        ReadOnly = true,
+        Idempotent = true,
+        Destructive = false),
+        Description("Returns table schema")]
     public async Task<DbOperationResult> DescribeTable(
         [Description("Name of table")] string name)
     {

MssqlMcp/MssqlMcp/Tools/DropTable.cs

@@ -9,7 +9,11 @@ namespace Mssql.McpServer;
 
 public partial class Tools
 {
-    [McpServerTool, Description("Drops a table in the SQL Database. Expects a valid DROP TABLE SQL statement as input.")]
+    [McpServerTool(
+        Title = "Drop Table",
+        ReadOnly = false,
+        Destructive = true),
+        Description("Drops a table in the SQL Database. Expects a valid DROP TABLE SQL statement as input.")]
     public async Task<DbOperationResult> DropTable(
         [Description("DROP TABLE SQL statement")] string sql)
     {

MssqlMcp/MssqlMcp/Tools/InsertData.cs

@@ -9,7 +9,11 @@ namespace Mssql.McpServer;
 
 public partial class Tools
 {
-    [McpServerTool, Description("Updates data in a table in the SQL Database. Expects a valid INSERT SQL statement as input. ")]
+    [McpServerTool(
+        Title = "Insert Data",
+        ReadOnly = false,
+        Destructive = false),
+        Description("Updates data in a table in the SQL Database. Expects a valid INSERT SQL statement as input. ")]
     public async Task<DbOperationResult> InsertData(
         [Description("INSERT SQL statement")] string sql)
     {

MssqlMcp/MssqlMcp/Tools/ListTables.cs

@@ -12,7 +12,12 @@ public partial class Tools
 {
     private const string ListTablesQuery = @"SELECT TABLE_SCHEMA, TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_TYPE = 'BASE TABLE' ORDER BY TABLE_SCHEMA, TABLE_NAME";
 
-    [McpServerTool, Description("Lists all tables in the SQL Database.")]
+    [McpServerTool(
+        Title = "List Tables",
+        ReadOnly = true,
+        Idempotent = true,
+        Destructive = false),
+        Description("Lists all tables in the SQL Database.")]
     public async Task<DbOperationResult> ListTables()
     {
         var conn = await _connectionFactory.GetOpenConnectionAsync();

MssqlMcp/MssqlMcp/Tools/ReadData.cs

@@ -9,7 +9,12 @@
 namespace Mssql.McpServer;
 public partial class Tools
 {
-    [McpServerTool, Description("Executes SQL queries against SQL Database to read data")]
+    [McpServerTool(
+        Title = "Read Data",
+        ReadOnly = true,
+        Idempotent = true,
+        Destructive = false),
+        Description("Executes SQL queries against SQL Database to read data")]
     public async Task<DbOperationResult> ReadData(
         [Description("SQL query to execute")] string sql)
     {

MssqlMcp/MssqlMcp/Tools/UpdateData.cs

@@ -9,7 +9,11 @@ namespace Mssql.McpServer;
 
 public partial class Tools
 {
-    [McpServerTool, Description("Updates data in a table in the SQL Database. Expects a valid UPDATE SQL statement as input.")]
+    [McpServerTool(
+        Title = "Update Data",
+        ReadOnly = false,
+        Destructive = true),
+        Description("Updates data in a table in the SQL Database. Expects a valid UPDATE SQL statement as input.")]
     public async Task<DbOperationResult> UpdateData(
         [Description("UPDATE SQL statement")] string sql)
     {

MssqlMcp/README.md

@@ -37,12 +37,16 @@ This project is a .NET 8 console application implementing a Model Context Protoc
 
 2. VSCode: **Start VSCode, and add MCP Server config to VSCode Settings**
 
+Load the settings file in VSCode (Ctrl+Shift+P > Preferences: Open Settings (JSON)).
+
+Add a new MCP Server with the following settings:
+
 ---
 ```json
-"MSSQL MCP": {
-	"type": "stdio",
-	"command": "C:\\src\\MssqlMcp\\MssqlMcp\\bin\\Debug\\net8.0\\MssqlMcp.exe",
-	"env": {
+    "MSSQL MCP": {
+        "type": "stdio",
+        "command": "C:\\src\\MssqlMcp\\MssqlMcp\\bin\\Debug\\net8.0\\MssqlMcp.exe",
+        "env": {
             "CONNECTION_STRING": "Server=.;Database=test;Trusted_Connection=True;TrustServerCertificate=True"
             }
 }
@@ -56,7 +60,6 @@ e.g. your MCP settings should look like this if "MSSQL MCP" is your own MCP Serv
 ---
 ```json
 "mcp": {
-
     "servers": {
         "MSSQL MCP": {
             "type": "stdio",
@@ -69,11 +72,10 @@ e.g. your MCP settings should look like this if "MSSQL MCP" is your own MCP Serv
 ```
 ---
 
-And example of using a connection string for Azure SQL Database:
+An example of using a connection string for Azure SQL Database:
 ---
 ```json
 "mcp": {
-
     "servers": {
         "MSSQL MCP": {
             "type": "stdio",
@@ -88,13 +90,13 @@ And example of using a connection string for Azure SQL Database:
 
 **Run the MCP Server**
 
-Save the Settings file, and then you should see the "Start" button appear in the Settings json.  Click "start" to start the MCP Server.
+Save the Settings file, and then you should see the "Start" button appear in the settings.json.  Click "Start" to start the MCP Server. (You can then click on "Running" to view the Output window).
 
 Start Chat (Ctrl+Shift+I), make sure Agent Mode is selected.
 
 Click the tools icon, and ensure the "MSSQL MCP" tools are selected.
 
-Then type in the chat window "List tables in DB" and hit enter.
+Then type in the chat window "List tables in the database" and hit enter. (If you have other tools loaded, you may need to specify "MSSQL MCP" in the initial prompt, e.g. "Using MSSQL MCP, list tables").
 
 3. Claude Desktop: **Add MCP Server config to Claude Desktop**
 
@@ -116,12 +118,13 @@ Add a new MCP Server with the following settings:
     }
 }
 ```
+---
 
-Save the file, start a new Chat, you'll see the "Tools" icon, it should list 8 MSSQL MCP tools.
+Save the file, start a new Chat, you'll see the "Tools" icon, it should list 7 MSSQL MCP tools.
 
 # Troubleshooting
 
-1. If you get a connection reset error using "Active Directory Default", try "Active Directory Interactive"
+1. If you get a "Task canceled" error using "Active Directory Default", try "Active Directory Interactive".