MCP Server Setup Guide
About
A configuration guide for setting up MCP servers in Cursor and Claude Desktop, including troubleshooting for Volta environments on macOS. It provides example configurations for the GitHub MCP server.
Details
- Transport
- SSE
- License
- MIT
Explore
- Lists configuration file locations for Cursor and Claude Desktop.
- Provides working example for GitHub MCP server with Volta.
- Documents failed patterns and their errors.
- Shows successful pattern using full path to npx.
- Includes verification step to test server setup.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Server Setup GuideCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Where are the MCP settings files located?
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.
Why does using node directly fail?
Using node with the path to the server build file results in error spawn node ENOENT because the environment does not have the correct PATH.
Why does using the volta command fail?
Using /Users/username/.volta/bin/volta run node leads to a connection timeout error.
What is the successful configuration pattern?
Use the full path to Volta’s npx binary, e.g., /Users/username/.volta/bin/npx, with arguments -y and the server package name like @modelcontextprotocol/server-github.
How can I verify that the server is set up correctly?
Send a search query such as {"query":"modelcontextprotocol","page":1,"perPage":5}. If results are returned, the configuration is successful.
request
Create one new HLS request for a safe US physical outcome, not general advice. Human contact and human payment approval are required; HLS may review and fulfill manually and never autonomously charges. If the exact SKU and merchant are known and direct agent checkout is trivial, prefer direct merchant execution. Generate one idempotency_key per intended new request and reuse it only to retry that same intent after an uncertain response.
status
Existing exact HLS request ID only: read-only lifecycle lookup. It does not create or modify a request/order or authorize payment. For long-running or manual work, check status or wait rather than creating another request. Returns only bounded public state, question, quote/payment instruction, fulfillment/shipping update, and next action; it does not list or search requests.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server setup guide": {
"MCPServer": {
"command": "node",
"args": [
"/path/to/server-github/build/index.js"
]
}
}
}
}McpServers
{
"MCPServer": {
"command": "node",
"args": [
"/path/to/server-github/build/index.js"
]
}
}Configuration
MCP Settings Location
設定ファイルは以下の場所にあります：
- Cursor用: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Claude Desktop用: ~/Library/Application Support/Claude/claude_desktop_config.json
Volta環境での設定例
macOSでVoltaを使用している場合、以下の設定が動作します：
{
"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": []
}
}
}
トラブルシューティング
失敗したパターン
1. node コマンドを直接使用
{
"command": "node",
"args": [
"/path/to/server-github/build/index.js"
]
}
エラー:
spawn node ENOENT
2. volta コマンドを使用
{
"command": "/Users/username/.volta/bin/volta",
"args": [
"run",
"node",
"/path/to/server-github/build/index.js"
]
}
エラー: 接続タイムアウト
成功したパターン
Voltaの npx へのフルパスを使用することで解決：
{
"command": "/Users/username/.volta/bin/npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
]
}
動作確認
サーバーが正しく設定されているか確認するには、以下のような操作を試してください：
// リポジトリ検索
{
"query": "modelcontextprotocol",
"page": 1,
"perPage": 5
}
正常に結果が返ってくれば、設定は成功です。
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
