Skip to content

README.md

Latest commit

 

History

History
394 lines (289 loc) · 18.7 KB

README.md

File metadata and controls

394 lines (289 loc) · 18.7 KB

लोकप्रिय MCP होस्ट क्लाइन्टहरू सेट अप गर्ने तरिका

यस मार्गनिर्देशनले लोकप्रिय AI होस्ट अनुप्रयोगहरूसँग MCP सर्भरहरू कसरी कन्फिगर गर्ने र प्रयोग गर्ने बारेमा कभर गर्दछ। प्रत्येक होस्टको आफ्नै कन्फिगरेसन विधि हुन्छ, तर एक पटक सेट अप भएपछि, ती सबै MCP सर्भरहरूसँग मानकीकृत प्रोटोकल प्रयोग गरेर संवाद गर्छन्।

MCP होस्ट भनेको के हो?

एक MCP होस्ट भनेको यस्तो AI अनुप्रयोग हो जुन MCP सर्भरहरूसँग जडान गर्न सक्षम हुन्छ र आफ्नो क्षमता विस्तार गर्दछ। यसलाई यस्तो "फ्रन्ट एन्ड" भनेर सोच्नुस् जुन प्रयोगकर्ताहरूले अन्तरक्रिया गर्छन्, जबकि MCP सर्भरहरूले "ब्याक एन्ड" उपकरणहरू र डाटा उपलब्ध गराउँछन्।

flowchart LR
    User[👤 प्रयोगकर्ता] --> Host[🖥️ MCP होस्ट]
    Host --> S1[MCP सर्भर A]
    Host --> S2[MCP सर्भर B]
    Host --> S3[MCP सर्भर C]
    
    subgraph "लोकप्रिय होस्टहरू"
        H1[क्लाउड डेस्कटप]
        H2[VS कोड]
        H3[कर्सर]
        H4[क्लाइन]
        H5[विन्डसर्फ]
    end
Loading

आवश्यकताहरू

  • जडान गर्नको लागि MCP सर्भर (हेर्नुहोस् Module 3.1 - First Server)
  • तपाईंको प्रणालीमा होस्ट अनुप्रयोग स्थापना गरिएको हुनुपर्छ
  • JSON कन्फिग्युरेसन फाइलहरूसँग आधारभूत परिचय

1. Claude Desktop

Claude Desktop Anthropic को आधिकारिक डेस्कटप अनुप्रयोग हो जसले स्वाभाविक रूपमा MCP समर्थन गर्दछ।

स्थापना

  1. Claude Desktop डाउनलोड गर्नुहोस् claude.ai/download
  2. स्थापना गर्नुहोस् र आफ्नो Anthropic खाता प्रयोग गरेर साइन इन गर्नुहोस्

कन्फिगरेसन

Claude Desktop ले MCP सर्भरहरू परिभाषित गर्न JSON कन्फिग्युरेसन फाइल प्रयोग गर्दछ।

कन्फिग्युरेसन फाइल स्थान:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

कन्फिगरेसन उदाहरण:

{
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"],
      "env": {
        "PYTHONPATH": "/path/to/your/server"
      }
    },
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-server/build/index.js"]
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
      }
    }
  }
}

कन्फिगरेसन विकल्पहरू

क्षेत्र विवरण उदाहरण
command चलाउने योग्य फाइल "python", "node", "npx"
args कमाण्ड लाइन आर्गुमेन्टहरू ["-m", "my_server"]
env वातावरण चरहरू {"API_KEY": "xxx"}
cwd काम गर्ने निर्देशिका "/path/to/server"

तपाईको सेटअप परीक्षण गर्ने तरिका

  1. कन्फिग्युरेसन फाइल सेव गर्नुहोस्
  2. Claude Desktop पूर्णरूपमा पुनः सुरु गर्नुहोस् (Quit गरेर फेरि खोल्नुहोस्)
  3. नयाँ संवाद खोल्नुहोस्
  4. जडान भएका सर्भरहरू देखाउन 🔌 आइकन खोज्नुहोस्
  5. तपाईको उपकरणहरू मध्ये कुनै एउटा प्रयोग गरेर Claude लाई सोध्न प्रयास गर्नुहोस्

Claude Desktop समस्या समाधान

सर्भर देखिँदैन:

  • JSON मान्यकर्ता प्रयोग गरेर कन्फिग्युरेसन फाइलको सिन्ट्याक्स जाँच गर्नुहोस्
  • कमाण्ड पथ सही छ भनी सुनिश्चित गर्नुहोस्
  • Claude Desktop लग फाइलहरू जाँच गर्नुहोस्: Help → Show Logs

सर्भर स्टार्ट हुँदा क्र्यास हुन्छ:

  • पहिले टर्मिनलमा म्यानुअली तपाईको सर्भर परीक्षण गर्नुहोस्
  • वातावरण चरहरू सही सेट गरिएको छ कि छैन जाँच गर्नुहोस्
  • सबै निर्भरताहरू स्थापना गरिएको छ पक्का गर्नुहोस्

2. VS Code with GitHub Copilot

VS Code ले GitHub Copilot Chat विस्तार मार्फत MCP समर्थन गर्दछ।

आवश्यकताहरू

  1. VS Code 1.99+ स्थापना गरिएको हुनुपर्ने
  2. GitHub Copilot विस्तार स्थापना गरिएको हुनुपर्ने
  3. GitHub Copilot Chat विस्तार स्थापना गरिएको हुनुपर्ने

कन्फिगरेसन

VS Code ले तपाईको कार्यक्षेत्र वा प्रयोगकर्ता सेटिङहरूमा .vscode/mcp.json प्रयोग गर्दछ।

कार्यक्षेत्र कन्फिगरेसन (.vscode/mcp.json):

{
  "servers": {
    "my-calculator": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    },
    "my-database": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

प्रयोगकर्ता सेटिङहरू (settings.json):

{
  "mcp.servers": {
    "global-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-memory"]
    }
  },
  "mcp.enableLogging": true
}

VS Code मा MCP प्रयोग गर्ने तरिका

  1. Copilot Chat प्यानल खोल्नुहोस् (Ctrl+Shift+I / Cmd+Shift+I)
  2. उपलब्ध MCP उपकरणहरू हेर्न @ टाइप गर्नुहोस्
  3. प्राकृतिक भाषा प्रयोग गरेर उपकरणहरू चलाउनुहोस्: "Calculate 25 * 48 using the calculator"

VS Code समस्या समाधान

MCP सर्भरहरू लोड हुँदैनन्:

  • Output प्यानल → "MCP" मा त्रुटि लगहरू जाँच गर्नुहोस्
  • विन्डो पुनः लोड गर्नुहोस्: Ctrl+Shift+P → "Developer: Reload Window"
  • पहिले सर्भरलाई स्वतन्त्र रूपमा चलाएर जाँच गर्नुहोस्

3. Cursor

Cursor एक AI-प्रथम कोड एडिटर हो जसमा निर्मित MCP समर्थन छ।

स्थापना

  1. Cursor डाउनलोड गर्नुहोस् cursor.sh
  2. स्थापना गर्नुहोस् र साइन इन गर्नुहोस्

कन्फिगरेसन

Cursor ले Claude Desktop जस्तै कन्फिगरेसन ढाँचा प्रयोग गर्दछ।

कन्फिगरेसन फाइल स्थान:

  • macOS: ~/.cursor/mcp.json
  • Windows: %USERPROFILE%\.cursor\mcp.json
  • Linux: ~/.cursor/mcp.json

कन्फिगरेसन उदाहरण:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Cursor मा MCP प्रयोग गर्ने तरिका

  1. Cursor को AI च्याट खोल्नुहोस् (Ctrl+L / Cmd+L)
  2. MCP उपकरणहरू सुझावहरूमा स्वचालित देखिन्छन्
  3. जडित सर्भरहरू प्रयोग गरेर AI लाई कार्यहरू गर्न भन्नुहोस्

4. Cline (Terminal-Based)

Cline टर्मिनल-आधारित MCP क्लाइन्ट हो, कमाण्ड लाइन कार्यप्रवाहका लागि उपयुक्त।

स्थापना

npm install -g @anthropic/cline

कन्फिगरेसन

Cline ले वातावरण चरहरू र कमाण्ड लाइन आर्गुमेन्टहरू प्रयोग गर्छ।

वातावरण चरहरू प्रयोग गर्ने तरिका:

export ANTHROPIC_API_KEY="your-api-key"
export MCP_SERVER_CALCULATOR="python -m mcp_calculator_server"

कमाण्ड लाइन आर्गुमेन्टहरू प्रयोग गर्ने तरिका:

cline --mcp-server "calculator:python -m mcp_calculator_server" \
      --mcp-server "weather:node /path/to/weather/index.js"

कन्फिगरेसन फाइल (~/.clinerc):

{
  "apiKey": "your-api-key",
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    }
  }
}

Cline प्रयोग गर्ने तरिका

# अन्तरक्रियात्मक सत्र सुरु गर्नुहोस्
cline

# MCP सँग एकल सोध
cline "Calculate the square root of 144 using the calculator"

# उपलब्ध उपकरणहरूको सूची बनाउनुहोस्
cline --list-tools

5. Windsurf

Windsurf अर्को AI-शक्ति भएको कोड एडिटर हो जसमा MCP समर्थन छ।

स्थापना

  1. Windsurf डाउनलोड गर्नुहोस् codeium.com/windsurf
  2. स्थापना गर्नुहोस् र खाता सिर्जना गर्नुहोस्

कन्फिगरेसन

Windsurf को कन्फिगरेसन सेटिङ UI बाट व्यवस्थापन गरिन्छ:

  1. सेटिङहरू खोल्नुहोस् (Ctrl+, / Cmd+,)
  2. "MCP" खोज्नुहोस्
  3. "Edit in settings.json" क्लिक गर्नुहोस्

कन्फिगरेसन उदाहरण:

{
  "windsurf.mcp.servers": {
    "my-tools": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {}
    }
  },
  "windsurf.mcp.enabled": true
}

ट्रान्सपोर्ट प्रकारहरूको तुलना

विभिन्न होस्टहरूले विभिन्न ट्रान्सपोर्ट मेकानिजमहरू समर्थन गर्दछन्:

होस्ट stdio SSE/HTTP WebSocket
Claude Desktop ✅ ❌ ❌
VS Code ✅ ✅ ❌
Cursor ✅ ✅ ❌
Cline ✅ ✅ ❌
Windsurf ✅ ✅ ❌

stdio (मानक इनपुट/आउटपुट): स्थानीय होस्टद्वारा सुरु गरिएका सर्भरहरूका लागि राम्रो SSE/HTTP: दूरस्थ सर्भरहरू वा धेरै क्लाइन्टहरू बीच सर्भर साझा गर्दा राम्रो

सामान्य समस्या समाधान

सर्भर सुरु हुँदैन

  1. पहिले सर्भर म्यानुअली परीक्षण गर्नुहोस्:

    # पायथनको लागि
python -m your_server_module

# नोड.जेएसको लागि
node /path/to/server/index.js

  2. कमान्ड पथ जाँच्नुहोस्:

    • सम्भव भएमा पूर्ण पथ प्रयोग गर्नुहोस्
    • चलाउने योग्य फाइल PATH मा छ कि छैन निश्चित गर्नुहोस्

  3. निर्भरता जाँच्नुहोस्:

    # पाइथन
pip list | grep mcp

# नोड.जेएस
npm list @modelcontextprotocol/sdk

सर्भर जडान हुन्छ तर उपकरणहरू काम गर्दैनन्

  1. सर्भर लगहरू जाँच गर्नुहोस् - प्रायः होस्टहरूले लगिङ विकल्पहरू राख्छन्
  2. उपकरण दर्ता जाँच गर्नुहोस् - MCP Inspector प्रयोग गरी परीक्षण गर्नुहोस्
  3. अनुमतिहरू जाँच गर्नुहोस् - केही उपकरणहरूलाई फाइल/नेटवर्क पहुँच आवश्यक पर्छ

वातावरण चरहरू नपठाइएका छन्

  • केही होस्टहरूले वातावरण चरहरू सफा गर्छन्
  • env कन्फिगरेशन फिल्ड स्पष्ट रूपमा प्रयोग गर्नुहोस्
  • संवेदनशील डाटालाई कन्फिग फाइलमा नराख्नुहोस् (गोप्य व्यवस्थापन प्रयोग गर्नुहोस्)

सुरक्षा उत्कृष्ट अभ्यासहरू

  1. कुनै पनि API कुञ्जी कन्फिग फाइलहरूमा कमिट नगर्नुहोस्
  2. संवेदनशील डाटाका लागि वातावरण चरहरू प्रयोग गर्नुहोस्
  3. सर्भर अनुमति केवल आवश्यक पर्ने चीजमा सीमित गर्नुहोस्
  4. तपाईंको प्रणालीमा पहुँच दिनु अघि सर्भर कोड समीक्षा गर्नुहोस्
  5. फाइल सिस्टम र नेटवर्क पहुँचका लागि allowlists प्रयोग गर्नुहोस्

अब के गर्ने

थप स्रोतहरू

अस्वीकरण: यस दस्तावेजलाई AI अनुवाद सेवा Co-op Translator को प्रयोग गरेर अनुवाद गरिएको छ। हामी शुद्धताका लागि प्रयासरत छौं, तर कृपया ध्यान दिनुहोस् कि स्वचालित अनुवादमा त्रुटि वा गलतियाँ हुन सक्छन्। मूल दस्तावेज यसको मातृभाषामै अधिकारिक स्रोतको रूपमा मानिनु पर्छ। महत्वपूर्ण जानकारीको लागि पेशेवर मानवीय अनुवाद सिफारिस गरिन्छ। यस अनुवादको प्रयोगबाट उत्पन्न हुने कुनै पनि बुझाइको त्रुटि वा गलत अर्थ लगाउन हामी जिम्मेवार हुनेछैनौं।