MCP Server Setup Guide

🚀 MCP Server Setup Guide

This guide provides a detailed process for setting up the MCP server, including configuration steps, common issue troubleshooting, and functionality verification.

🚀 Quick Start

Configuration

Location of MCP Settings Files

The settings files are located at the following paths:

• For Cursor: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• For Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

Configuration Example Using Volta Environment

When using Volta on macOS, the following configuration works properly:

{
  "mcpServers": {
    "github.com/modelcontextprotocol/servers/tree/main/src/github": {
      "command": "/Users/username/.volta/bin/npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Troubleshooting Common Issues

Failed Modes

1. Running directly with the node command

{
  "command": "node",
  "args": [
    "/path/to/server-github/build/index.js"
  ]
}

Error: spawn node ENOENT

2. Using the volta command

{
  "command": "/Users/username/.volta/bin/volta",
  "args": [
    "run",
    "node",
    "/path/to/server-github/build/index.js"
  ]
}

Error: Connection timeout

Successful Mode

The issue can be resolved by using the full path of Volta's npx:

{
  "command": "/Users/username/.volta/bin/npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-github"
  ]
}

💻 Usage Examples

Functionality Verification

To confirm whether the server is properly set up, try the following operation:

// Repository search
{
  "query": "modelcontextprotocol",
  "page": 1,
  "perPage": 5
}

If the results are returned normally, it indicates that the configuration is successful.