Lallen30 MCP Remote Server

🚀 BluestoneApps MCP Remote Server

This server implements the Model Context Protocol (MCP) over HTTP, enabling remote access to BluestoneApps coding standards and code examples.

🚀 Quick Start

This server implements the Model Context Protocol (MCP) via HTTP, allowing remote access to BluestoneApps coding standards and code examples.

✨ Features

• Implements the MCP protocol over HTTP using JSON - RPC 2.0.
• Supports Server - Sent Events (SSE) for streaming responses.
• Provides access to coding standards and code examples.
• Supports authentication.
• Supports Docker deployment.
• HTTPS support via the domain: https://mcp.betaplanets.com

📦 Installation

1. Install the dependencies:

pip install -r requirements.txt

2. Configure the server by editing the .env file:

MCP_TRANSPORT=http
MCP_HOST=0.0.0.0
MCP_PORT=8000
MCP_AUTH_ENABLED=true
MCP_AUTH_USERNAME=mcp-server
MCP_AUTH_PASSWORD=n2hXUijptRwpe9v6wZ37yOgEx4P8w3ofDRO0ko4A

3. Copy the resource directory of the local MCP server:

cp -r ../mcp-server/resources ./

💻 Usage Examples

Local Running

python simple_mcp_server.py

Testing

Local Testing

# Start the server
python simple_mcp_server.py

# In another terminal, run the test script
./test_mcp_server.sh

Remote Testing

# Test the remote server (IP address)
./test_remote_server.sh

# Test the domain
./test_domain.sh

Docker Deployment

# Build and push the Docker image
./build_and_push.sh

# Deploy to the remote server
./deploy.sh

Connecting with Windsurf/Cascade

Add the following content to the MCP configuration file (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "bluestoneapps-remote": {
      "transport": "http",
      "url": "http://your-server-ip:5051",
      "headers": {
        "Authorization": "Basic YWRtaW46Y2hhbmdlbWU="
      },
      "description": "BluestoneApps coding standards and examples (remote)",
      "displayName": "BluestoneApps development standards (remote)"
    }
  }
}

⚠️ Important Note

The Authorization header is base64(username:password). For the default credentials (admin:changeme), it is YWRtaW46Y2hhbmdlbWU=.

📚 Documentation

Available Tools

• get_project_structure: Get the project structure standards for React Native development.
• get_api_communication: Get the API communication standards for React Native development.
• get_component_design: Get the React Native component design standards.
• get_state_management: Get the React Native state management standards.
• get_component_example: Get React Native component examples.
• get_hook_example: Get React Native hook examples.
• get_service_example: Get React Native service examples.
• get_screen_example: Get React Native screen examples.
• get_theme_example: Get React Native theme examples.
• list_available_examples: List all available code examples by category.