MCP Test Server

You can spin up an MCP Test Server to experiment with CSV and image resource parsing, verify Server-Sent Events transport, and debug client connections using a built-in test page.

How to use

Connect your MCP client to either the local server during development or the deployed server when you have it running. You can access the MCP SSE endpoint to receive live updates and resources such as sample CSV data and images. Use the test page for quick debugging and to verify that your client properly handles the available resources.

How to install

Prerequisites you need: to run this MCP server locally, you should have Node.js installed on your machine. Make sure npm is available as it is used to install dependencies and start the server.

Step by step to set up locally:

npm install
npm start

Deployment options and endpoints

Deploy to a hosting service to expose the MCP server publicly. After deployment, your MCP SSE endpoint will be available at the deployed URL followed by /sse.

Local development endpoints you can use immediately after starting the server:

• SSE endpoint: http://localhost:3000/sse
• Health check: http://localhost:3000/health
• Test page: http://localhost:3000/

If you deploy, you will access the SSE endpoint at your hosted URL with /sse appended, for example: https://your-app-name.onrender.com/sse

Endpoints and resources

Resources provided by the server include sample data and images you can fetch via the following URIs:

• csv://sample-data — Basic CSV with user data
• csv://employees — Employee information CSV
• image://test-image — Small PNG image
• image://logo — Small JPEG image

Notes and troubleshooting

No authentication is required to connect to the MCP server. If you encounter connectivity issues, verify that the server is running and that you are using the correct SSE endpoint for your environment (local or deployed). Use the test page to confirm that your client can subscribe to SSE streams and render the provided resources.

Available tools

csv_resource_serving

Serves CSV resources with sample data for client testing.

image_resource_serving

Serves image resources (PNG/JPEG) as base64-encoded blobs for client rendering.

sse_transport

Provides Server-Sent Events transport for remote MCP communication.

test_page

Includes a test/debug page to verify connections and resource handling.