Adding and Managing MCP Servers

Via Configuration File

The primary method involves editing the MCP configuration file, typically named mcp.json. This approach offers precise control and is ideal for developers comfortable with JSON editing.

Via Add Sever PureCode UI

For users preferring a guided approach, the PureCode UI provides forms to add servers without directly editing JSON files.

Server Management Dashboard

Status Meeting

Real-time connection status: connected, error, or loading

Tool Discovery

Browse all available tools exposed by each MCP server

Configuration

Edit, enable/disable, or remove server configurations

Restart Required

After making configuration changes, restart the extension or reload its configuration for changes to take effect. This ensures proper synchronization with MCP servers.

MCP Server Configurations

GitHub Integration

Connect to Github's API using the official GitHub MCP server running in Docker

"github": {
  "name": "GitHub Integration",
  "id": "github",
  "transport": {
    "type": "stdio",
    "command": "docker",
    "args": [
      "run", "-i", "--rm", "-e",
      "GITHUB_PERSONAL_ACCESS_TOKEN",
      "ghcr.io/github/github-mcp-server"
    ],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"
    }
  }
}

Custom API Integration

Connect to any custom or third-party API by wrapping it in an MCP server.

"searchapi": {
  "name": "Search API",
  "id": "searchapi",
  "transport": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "search1api-mcp"],
    "env": {
      "SEARCH1API_KEY": "your_api_key_here"
    }
  }
}

Filesystem Indexing

Access local project files and directories using the @modelcontextprotocol/server-filesystem package.

"file-system": {
  "name": "Local Filesystem Access",
  "id": "file-system",
  "transport": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/projects"]
  }
}

Remote HTTP Services

Connect to MCP servers running as remote HTTP services using Server-Sent Events.

"remote-service": {
  "name": "Remote MCP Service",
  "id": "remote-service",
  "transport": {
    "type": "sse",
    "url": "https://api.example.com/mcp-events"
  }
}

User Experience with MCP-Enabled Tools

Tool Discovery

Once connected, MCP server tools automatically appear in the PureCode sidebar, organized by server. Each tool shows its human-readable name and current status.

Detailed Information

Expand any tool call to view comprehensive details including the tool name, arguments passed, execution status, and complete results or error messages.

Real-time Feedback

During tool execution, users see live status indicators, progress updates, and immediate results. The interface provides clear visual cues for active operations.

Error Handling

Clear error messages and partial results are displayed when tool calls encounter issues, allowing for quick troubleshooting and recovery.