RiverbedMcpDataServer 0.1.2-beta

Riverbed MCP Data Server

A Model Context Protocol (MCP) server built with .NET that provides various tools for generating sample data. This server can be integrated with VS Code Chat and other MCP clients to provide useful data generation capabilities.

🚀 Features

Available Tools

RandomNumberTools

• GetRandomNumber(min, max) - Generates a random number between specified minimum and maximum values
  • min (optional): Minimum value (inclusive), default: 0
  • max (optional): Maximum value (exclusive), default: 100

CompanyNameTools

• GetCompanyNames() - Returns a list of 15 sample company names for testing and demonstration purposes

📋 Requirements

• .NET 10.0 or later
• Visual Studio Code (for VS Code Chat integration)

🛠️ Installation & Setup

1. Clone the Repository

git clone https://github.com/YOUR_USERNAME/Riverbed.MCP.Data.Server.git
cd Riverbed.MCP.Data.Server

2. Build the Project

dotnet build

3. Run the Server

dotnet run

🔧 VS Code Chat Integration

To use this MCP server with VS Code Chat, add the following to your VS Code settings:

Workspace Settings (.vscode/settings.json)

{
    "github.copilot.chat.modelContextProtocol.servers": {
        "riverbed-data-server": {
            "command": "dotnet",
            "args": ["run"],
            "cwd": "path/to/Riverbed.MCP.Data.Server"
        }
    }
}

User Settings (settings.json)

For global access across all workspaces, add to your user settings:

{
    "github.copilot.chat.modelContextProtocol.servers": {
        "riverbed-data-server": {
            "command": "dotnet",
            "args": ["run"],
            "cwd": "full/path/to/Riverbed.MCP.Data.Server"
        }
    }
}

📖 Usage Examples

Once configured with VS Code Chat, you can use the tools by asking:

• "Generate 5 random numbers"
• "Get me some company names"
• "Create a table with 10 random numbers between 1 and 100"
• "Show me company names in alphabetical order"

🧪 Testing & Debugging

Debug Harness

Run the debug harness to test tools independently:

dotnet run DebugHarness.cs

VS Code Debugging

1. Set breakpoints in your tool methods
2. Press F5 to start debugging
3. Use VS Code Chat to invoke the tools

Protocol Testing

Test the MCP protocol directly:

.\test-mcp-protocol.ps1

Developing locally

To test this MCP server from source code (locally) without using a built MCP server package, you can configure your IDE to run the project directly using dotnet run.

{
  "servers": {
    "Riverbed.MCP.Data.Server": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<PATH TO PROJECT DIRECTORY>"
      ]
    }
  }
}

Testing the MCP Server

Once configured, you can ask Copilot Chat for a random number, for example, Give me 3 random numbers. It should prompt you to use the get_random_number tool on the Riverbed.MCP.Data.Server MCP server and show you the results.

Publishing to NuGet.org

1. Run dotnet pack -c Release to create the NuGet package
2. Publish to NuGet.org with dotnet nuget push bin/Release/*.nupkg --api-key <your-api-key> --source https://api.nuget.org/v3/index.json

Using the MCP Server from NuGet.org

Once the MCP server package is published to NuGet.org, you can configure it in your preferred IDE. Both VS Code and Visual Studio use the dnx command to download and install the MCP server package from NuGet.org.

• VS Code: Create a <WORKSPACE DIRECTORY>/.vscode/mcp.json file
• Visual Studio: Create a <SOLUTION DIRECTORY>\.mcp.json file

For both VS Code and Visual Studio, the configuration file uses the following server definition:

{
  "servers": {
    "Riverbed.MCP.Data.Server": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "<your package ID here>",
        "--version",
        "<your package version here>",
        "--yes"
      ]
    }
  }
}

More information

.NET MCP servers use the ModelContextProtocol C# SDK. For more information about MCP:

• Official Documentation
• Protocol Specification
• GitHub Organization

Refer to the VS Code or Visual Studio documentation for more information on configuring and using MCP servers:

• Use MCP servers in VS Code (Preview)
• Use MCP servers in Visual Studio (Preview)