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
- Author
- amurata
- Downloads
- 137
- Categories
- Other
Jump to
- 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.
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"
]
}
}MCP Server Setup Guide
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.
