Glama
BluestoneApps MCP Remote Server

# MCP Server Testing Guide

This guide explains how to test each MCP server individually to ensure they are working correctly.

## Available MCP Servers

1. **Local BluestoneApps MCP Server**
   - Provides coding standards and examples for React Native development
   - Runs locally on your machine

2. **Remote BluestoneApps MCP Server**
   - Same functionality as the local server but runs on a remote server
   - Accessible via HTTP at http://107.191.37.244:5051

## Testing Each Server Individually

We've created separate configuration files and test scripts to test each server individually:

### Local BluestoneApps MCP Server

```bash
./test_local_mcp.sh
```

This script will:
1. Set the MCP configuration to only use the local BluestoneApps server
2. Open a new Windsurf window with this configuration

Test prompts:
- "What are our project structure standards for React Native?"
- "Show me an example of a React Native Button component"
- "What are the API communication standards?"

### Remote BluestoneApps MCP Server

```bash
./test_remote_mcp.sh
```

This script will:
1. Set the MCP configuration to only use the remote BluestoneApps server
2. Open a new Windsurf window with this configuration

Test prompts:
- "What are our project structure standards for React Native?"
- "Show me an example of a React Native Button component"
- "What are the API communication standards?"

## Troubleshooting

### Common Issues

1. **Connection Errors**: Ensure the remote server is running and accessible
2. **Authentication Errors**: Verify the authentication headers are correct
3. **Tool Execution Errors**: Check the response format from the server

### Debugging

- Use curl to test the remote server directly:
  ```bash
  curl -X POST -H "Content-Type: application/json" -H "Authorization: Basic YWRtaW46bjJoWFVpanB0UndwZTl2NndaMzd5T2dFeDRQOHczb2ZEUk8wa280QQ==" -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' http://107.191.37.244:5051/jsonrpc
  ```

- Test specific tool calls:
  ```bash
  curl -X POST -H "Content-Type: application/json" -H "Authorization: Basic YWRtaW46bjJoWFVpanB0UndwZTl2NndaMzd5T2dFeDRQOHczb2ZEUk8wa280QQ==" -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_project_structure"},"id":1}' http://107.191.37.244:5051/jsonrpc
  ```

### Server Configuration

If you're having issues with the remote server, try these steps:

1. Rename the server in the configuration to avoid conflicts with the local server:
   ```json
   "bluestoneapps-remote": {
     "transport": "http",
     "url": "http://107.191.37.244:5051/jsonrpc",
     ...
   }
   ```

2. Make sure the HTTP transport configuration is correct

3. Check that the authentication headers are properly formatted

## Manual Configuration

You can also manually set the MCP configuration by copying the appropriate configuration file to the default location:

```bash
# For local BluestoneApps server
cp "/Users/lallen30/.codeium/windsurf/mcp_config_local.json" "/Users/lallen30/.codeium/windsurf/mcp_config.json"
open -a Windsurf

# For remote BluestoneApps server
cp "/Users/lallen30/.codeium/windsurf/mcp_config_remote.json" "/Users/lallen30/.codeium/windsurf/mcp_config.json"
open -a Windsurf
```

## Using All Servers Together

To use all servers together, restore the original MCP configuration:

```bash
# Create a backup of the current configuration if needed
cp "/Users/lallen30/.codeium/windsurf/mcp_config.json" "/Users/lallen30/.codeium/windsurf/mcp_config_backup.json"

# Copy the combined configuration
cp "/Users/lallen30/.codeium/windsurf/mcp_config_combined.json" "/Users/lallen30/.codeium/windsurf/mcp_config.json"
open -a Windsurf
```

This will enable all MCP servers, allowing you to use tools from any of them in the same Windsurf session.

## Troubleshooting

If you encounter issues with an MCP server:

1. Check that the server is running (for local servers)
2. Verify the authentication credentials are correct
3. Ensure the server is accessible from your network
4. Check the server logs for any errors
5. Restart Windsurf after making configuration changes