SIPp MCP Server

A Model Context Protocol (MCP) server for interacting with SIPp, the SIP protocol testing tool.

Use SIPp testing capabilities directly from Claude Desktop, VS Code, or any MCP-compatible client!

Quick Start

Install from npm

npm install -g sipp-mcp-server

Or install from source

# Clone the repository
git clone https://github.com/randybritsch/sipp-mcp-server.git
cd sipp-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js

Then configure in Claude Desktop or VS Code.

Features

This MCP server provides tools to:

• Run SIPp Scenarios: Execute SIPp tests in UAC (client) or UAS (server) mode

• Create Custom Scenarios: Generate custom XML scenario files for testing

• Get Statistics: Parse and display SIPp test statistics

• Check Version: Verify SIPp installation and version

Prerequisites

• Node.js 16 or higher

• SIPp installed and available in your PATH

  • Download from: https://github.com/SIPp/sipp

  • Or install via package manager:

    • Ubuntu/Debian: sudo apt-get install sipp

    • macOS: brew install sipp

    • Windows: Download binary from releases

Installation

If installed globally via npm, the server is automatically available as sipp-mcp-server.

If installed from source, use npm link to make it globally available, or reference the full path to build/index.js in your configuration.

Setup Instructions

Setup with Claude Desktop

Follow these steps to integrate the SIPp MCP server with Claude Desktop:

Step 1: Locate the Claude Desktop Configuration File

Open your Claude Desktop configuration file:

Windows:

# Open in notepad
notepad %APPDATA%\Claude\claude_desktop_config.json

# Or open in VS Code
code %APPDATA%\Claude\claude_desktop_config.json

macOS:

# Open in default editor
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Or open in VS Code
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Step 2: Add the SIPp MCP Server Configuration

Add the following configuration to your claude_desktop_config.json file:

Using global npm installation (recommended):

{
  "mcpServers": {
    "sipp": {
      "command": "sipp-mcp-server"
    }
  }
}

Or using local installation:

Windows:

{
  "mcpServers": {
    "sipp": {
      "command": "node",
      "args": ["C:\\Users\\YOUR_USERNAME\\sipp-mcp-server\\build\\index.js"]
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "sipp": {
      "command": "node",
      "args": ["/absolute/path/to/sipp-mcp-server/build/index.js"]
    }
  }
}

Important:

• If using local installation, replace YOUR_USERNAME or the path with your actual absolute path

• On Windows, use double backslashes (\\) in the JSON file

• If you have other MCP servers, add the sipp entry to the existing mcpServers object

Step 3: Restart Claude Desktop

1. Completely quit Claude Desktop (not just close the window)

2. Relaunch Claude Desktop

3. The SIPp MCP server will start automatically

Step 4: Verify the Connection

1. Look for the MCP icon (🔌) in the bottom-right corner of the Claude chat input

2. Click the icon to see available tools

3. You should see the SIPp tools: run_sipp_scenario, create_sipp_scenario, get_sipp_statistics, and check_sipp_version

Step 5: Test the Server

Try asking Claude:

Check if SIPp is installed on my system

Claude should use the check_sipp_version tool to verify your SIPp installation.

Troubleshooting Claude Desktop

Server not appearing:

• Check that Node.js is installed: node --version

• Verify the path in your config file is correct and absolute

• Check Claude Desktop logs:

  • Windows: %APPDATA%\Claude\logs

  • macOS: ~/Library/Logs/Claude

Permission errors:

• Ensure the build/index.js file exists

• Run npm run build again if needed

Setup with VS Code

The SIPp MCP server can be used with VS Code through GitHub Copilot's agent mode.

Step 1: Ensure Prerequisites

1. Install the GitHub Copilot extension

2. Ensure you have Copilot access with agent mode enabled

3. Make sure the project is built: npm run build

Step 2: Configure MCP in VS Code

Using global npm installation (recommended):

Create .vscode/mcp.json in your workspace:

{
  "mcpServers": {
    "sipp": {
      "command": "sipp-mcp-server"
    }
  }
}

Or using local installation:

The MCP configuration file is already created at .vscode/mcp.json:

{
  "mcpServers": {
    "sipp": {
      "command": "node",
      "args": ["c:\\Users\\randy.britsch\\sipp-mcp-server\\build\\index.js"]
    }
  }
}

Update the path if your project is in a different location:

1. Open .vscode/mcp.json

2. Update the path in the args array to match your project location

3. Use double backslashes on Windows: c:\\Users\\...

Step 3: Alternative - User or Workspace Settings

You can also configure MCP servers in VS Code settings:

Option A: Workspace Settings (recommended for project-specific servers)

1. Open VS Code Command Palette (Ctrl+Shift+P or Cmd+Shift+P)

2. Type "Preferences: Open Workspace Settings (JSON)"

3. Add the MCP configuration:

{
  "mcp.servers": {
    "sipp": {
      "command": "node",
      "args": ["${workspaceFolder}/build/index.js"]
    }
  }
}

Option B: User Settings (for global access)

1. Open VS Code Command Palette (Ctrl+Shift+P or Cmd+Shift+P)

2. Type "Preferences: Open User Settings (JSON)"

3. Add the MCP configuration with absolute paths

Step 4: Enable and Use MCP Tools in Copilot

1. Open GitHub Copilot Chat panel (Ctrl+Alt+I or Cmd+Alt+I)

2. Start agent mode by typing @workspace or using the agent selector

3. The SIPp MCP tools will be available to the agent

Step 5: Test the Integration

In the Copilot Chat panel, try:

Use the SIPp tools to check if SIPp is installed

Or:

Create a basic SIPp scenario file named test.xml

Step 6: Using MCP Tools in Copilot Sessions

You can reference MCP tools in your conversations:

• Check SIPp version: "Check if SIPp is installed"

• Create scenarios: "Create a register scenario for testing SIP registration"

• Run tests: "Run a SIPp UAC test with 10 calls to 192.168.1.100"

• Get statistics: "Show me the statistics from sipp_output.csv"

Troubleshooting VS Code

MCP tools not appearing:

1. Verify the .vscode/mcp.json path is correct

2. Reload VS Code window (Ctrl+Shift+P → "Developer: Reload Window")

3. Check the Output panel (View → Output) and select "MCP" from the dropdown

Build issues:

# Rebuild the project
npm run build

# Verify the output file exists
ls build/index.js  # macOS/Linux
dir build\index.js  # Windows

Node.js not found:

• Ensure Node.js is in your PATH

• Restart VS Code after installing Node.js

• Use absolute path to node: "command": "C:\\Program Files\\nodejs\\node.exe"

Testing with MCP Inspector

For development and debugging, use the MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

This opens a web interface where you can:

• View all available tools

• Test tool inputs and outputs

• See real-time request/response logs

• Debug tool behavior

Available Tools

1. run_sipp_scenario

Execute a SIPp scenario for SIP protocol testing.

Parameters:

• mode: "uac" (client) or "uas" (server)

• remoteHost: Remote host IP (required for UAC mode)

• remotePort: Remote port (default: 5060)

• localPort: Local port to bind to

• scenarioFile: Path to custom XML scenario file

• callCount: Number of calls to make

• callRate: Call rate in calls per second

• duration: Maximum test duration in seconds

• transport: "udp", "tcp", or "tls"

• timeout: Global timeout in seconds

Example:

Run a UAC scenario with 10 calls to 192.168.1.100:5060

2. create_sipp_scenario

Create a custom SIPp XML scenario file.

Parameters:

• filename: Name of the scenario file

• scenarioType: "basic_call", "register", or "custom"

• customXml: Custom XML content (for custom type)

Example:

Create a basic call scenario named test.xml

3. get_sipp_statistics

Parse and display statistics from SIPp CSV output files.

Parameters:

• csvFile: Path to the SIPp statistics CSV file

4. check_sipp_version

Check if SIPp is installed and display version information.

Development

# Install dependencies
npm install

# Build the project
npm run build

# Watch mode for development
npm run dev

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js

Project Structure

sipp-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Example Usage

Example 1: Check SIPp Installation

Ask Claude or Copilot:

Check if SIPp is installed and show me the version

Expected behavior:

• The check_sipp_version tool will be invoked

• You'll see SIPp version information or an error if not installed

Example 2: Create a Basic Call Scenario

Ask Claude or Copilot:

Create a basic SIPp call scenario file named my_test.xml

Expected behavior:

• The create_sipp_scenario tool will be invoked

• A file named my_test.xml will be created with a basic UAC call flow

• The file contents will be displayed

Example 3: Run a Simple UAC Test

Ask Claude or Copilot:

Run a SIPp UAC test with 5 calls to 192.168.1.100 at a rate of 1 call per second

Expected behavior:

• The run_sipp_scenario tool will be invoked with:

  • mode: "uac"

  • remoteHost: "192.168.1.100"

  • callCount: 5

  • callRate: 1

• SIPp will execute the test

• Results and statistics will be shown

Example 4: Run a UAS (Server) Test

Ask Claude or Copilot:

Start SIPp in server mode on port 5060

Expected behavior:

• The run_sipp_scenario tool will be invoked with:

  • mode: "uas"

  • localPort: 5060

• SIPp will listen for incoming SIP calls

Example 5: Create and Use a REGISTER Scenario

Ask Claude or Copilot:

Create a REGISTER scenario file named register_test.xml, then run it against 192.168.1.100 with 10 registrations

Expected behavior:

• First, create_sipp_scenario creates the file

• Then, run_sipp_scenario executes it

• You'll see the registration test results

Example 6: Advanced Test with Custom Parameters

Ask Claude or Copilot:

Run a SIPp test against 10.0.0.50:5080 using TCP transport, with 100 calls at 10 calls per second, maximum duration of 60 seconds

Expected behavior:

• The run_sipp_scenario tool will be invoked with:

  • mode: "uac"

  • remoteHost: "10.0.0.50"

  • remotePort: 5080

  • transport: "tcp"

  • callCount: 100

  • callRate: 10

  • duration: 60

Example 7: Analyze Test Results

Ask Claude or Copilot:

Show me the statistics from the last SIPp test in sipp_output.csv

Expected behavior:

• The get_sipp_statistics tool will be invoked

• CSV contents will be parsed and displayed

• You can ask follow-up questions about the results

Troubleshooting

SIPp not found

Make sure SIPp is installed and in your PATH:

sipp -v

If not installed, follow the installation instructions for your platform.

Permission Issues

On Linux/macOS, you may need to run SIPp with appropriate permissions for binding to ports below 1024.

Connection Issues

• Verify the remote host is reachable

• Check firewall settings

• Ensure the SIP port (default 5060) is not blocked

• Try using different transport protocols (UDP, TCP, TLS)

Resources

• SIPp Documentation

• SIPp GitHub Repository

• Model Context Protocol Documentation

• MCP Servers Repository

Contributing

Contributions are welcome! Here's how you can help:

Reporting Issues

• Use the GitHub issue tracker

• Check existing issues before creating a new one

• Include SIPp version, Node.js version, and OS details

• Provide clear steps to reproduce any bugs

Submitting Pull Requests

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Make your changes

4. Run tests and build: npm run build

5. Commit your changes (git commit -m 'Add amazing feature')

6. Push to the branch (git push origin feature/amazing-feature)

7. Open a Pull Request

Development Guidelines

• Follow existing code style and TypeScript conventions

• Add appropriate error handling

• Update README.md if adding new features

• Test with MCP Inspector before submitting

Community

• Questions? Open a GitHub Discussion

• Bug Reports: Use GitHub Issues

• MCP Community: Join the MCP Discord

Roadmap

• Add support for more SIPp scenario templates

• Implement real-time statistics monitoring

• Add SIPp pcap file analysis tools

• Support for distributed SIPp testing

• Web-based scenario editor

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• SIPp Project - The excellent SIP testing tool

• Model Context Protocol - The protocol specification

• Anthropic - For Claude and MCP support

Made with ❤️ for the SIP testing community