mcp-function-app-tester

MCP Function App Tester

A TypeScript-based MCP server that enables testing of Azure Function Apps through Cline. This tool allows you to test and interact with Function App endpoints directly from your development environment.

Installation

npm install dkmaker-mcp-function-app-tester

Features

• Test Function App endpoints with different HTTP methods
• Support for GET, POST, PUT, and DELETE requests
• Detailed response information
• Custom header support
• Request body handling for POST/PUT methods
• Authentication support:
  • Basic Authentication (username/password)
  • Bearer Token Authentication
  • API Key Authentication (custom header)

Authentication

The server supports two authentication methods that can be configured via environment variables:

Basic Authentication

Set both environment variables to enable Basic Authentication:

AUTH_BASIC_USERNAME=your-username
AUTH_BASIC_PASSWORD=your-password

Bearer Token

Set this environment variable to enable Bearer Token authentication:

AUTH_BEARER=your-token

API Key

Set both environment variables to enable API Key authentication:

AUTH_APIKEY_HEADER_NAME=X-API-Key  # The header name to use (e.g., X-API-Key, api-key, etc.)
AUTH_APIKEY_VALUE=your-api-key     # The actual API key value

Note: Authentication precedence order:

1. Basic Authentication (if username and password are set)
2. Bearer Token (if token is set and Basic Auth is not configured)
3. API Key (if header name and value are set, and no other auth is configured)

Usage

Once installed, you can use the Function App Tester through Cline. The server provides tools to test endpoints at the base URL: http://localhost:7071/api

Example usage:

// Test a GET endpoint
{
  "method": "GET",
  "endpoint": "/users"
}

// Test a POST endpoint with body
{
  "method": "POST",
  "endpoint": "/users",
  "body": {
    "name": "John Doe",
    "email": "john@example.com"
  }
}

// Test with custom headers
{
  "method": "GET",
  "endpoint": "/secure/data",
  "headers": {
    "Authorization": "Bearer token123"
  }
}

Development

1. Clone the repository:

git clone https://github.com/dkmaker/mcp-function-app-tester.git
cd mcp-function-app-tester

2. Install dependencies:

npm install

3. Build the project:

npm run build

For development with auto-rebuild:

npm run watch

License

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