esa MCP Server

esa MCP सर्वर

日本語 | English

esa.io के लिए आधिकारिक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर - STDIO ट्रांसपोर्ट संस्करण।

अवलोकन

यह MCP सर्वर AI सहायकों और esa.io के बीच सहज एकीकरण प्रदान करता है, जो एक सहयोगी दस्तावेज़ीकरण प्लेटफ़ॉर्म है। यह AI सहायकों को मॉडल कॉन्टेक्स्ट प्रोटोकॉल के माध्यम से सीधे esa दस्तावेज़ों को पढ़ने, बनाने, अपडेट करने और प्रबंधित करने में सक्षम बनाता है।

उपलब्ध उपकरण

टीम प्रबंधन

• esa_get_teams - उपयोगकर्ता की सुलभ esa टीमें प्राप्त करें
• esa_get_team_stats - टीम के आँकड़े प्राप्त करें (सदस्य, पोस्ट, टिप्पणियाँ, सितारे, निगरानी, सक्रिय उपयोगकर्ता)
• esa_get_team_tags - टीम पोस्ट में उपयोग किए गए सभी टैग गणना सहित प्राप्त करें
• esa_get_team_members - भूमिकाओं और प्रोफ़ाइल जानकारी के साथ टीम के सदस्य प्राप्त करें

पोस्ट प्रबंधन

• esa_search_posts - esa.io में पोस्ट खोजें
• esa_get_post - पोस्ट संख्या द्वारा एक विशिष्ट पोस्ट प्राप्त करें (मुख्य भाग की वर्ण और पंक्ति गणना के साथ backlinks_count और body_md_stats शामिल हैं)
• esa_get_post_backlinks - पृष्ठांकन के साथ किसी विशिष्ट पोस्ट को संदर्भित करने वाली पोस्ट सूचीबद्ध करें
• esa_create_post - टैग, श्रेणी और WIP स्थिति के साथ एक नई पोस्ट बनाएँ
• esa_update_post - मौजूदा पोस्ट अपडेट करें (शीर्षक, सामग्री, टैग, श्रेणी, WIP स्थिति)
• esa_append_post - पोस्ट के मुख्य भाग के अंत में सामग्री जोड़ें (वर्तमान मुख्य भाग लाने की आवश्यकता नहीं; एक नए संशोधन के रूप में सहेजा जाता है)
• esa_prepend_post - पोस्ट के मुख्य भाग की शुरुआत में सामग्री जोड़ें (वर्तमान मुख्य भाग लाने की आवश्यकता नहीं; एक नए संशोधन के रूप में सहेजा जाता है)

पोस्ट कार्रवाइयाँ

• esa_archive_post - किसी पोस्ट को संग्रहीत/ श्रेणी में ले जाकर संग्रहित करें
• esa_ship_post - एक पोस्ट शिप करें (wip को गलत पर सेट करके पूर्ण के रूप में चिह्नित करें)
• esa_duplicate_post - एक पोस्ट की नकल बनाएँ (समान शीर्षक और मुख्य भाग के साथ एक नई WIP पोस्ट बनाएँ; क्रॉस-टीम नकल भी समर्थित है)

टिप्पणी प्रबंधन

• esa_get_comment - ID द्वारा एक विशिष्ट टिप्पणी प्राप्त करें
• esa_create_comment - किसी पोस्ट पर एक नई टिप्पणी बनाएँ
• esa_update_comment - मौजूदा टिप्पणी अपडेट करें
• esa_delete_comment - एक टिप्पणी हटाएँ
• esa_get_post_comments - पृष्ठांकन के साथ किसी विशिष्ट पोस्ट के लिए टिप्पणियाँ प्राप्त करें
• esa_get_team_comments - पृष्ठांकन के साथ टीम की टिप्पणियाँ प्राप्त करें

श्रेणी प्रबंधन

• esa_get_categories - किसी विशिष्ट पथ के लिए श्रेणियाँ और उपश्रेणियाँ प्राप्त करें
• esa_get_top_categories - किसी टीम के लिए सभी शीर्ष-स्तरीय श्रेणियाँ प्राप्त करें
• esa_get_all_category_paths - किसी टीम में सभी श्रेणी पथ प्राप्त करें (पोस्ट गणना के साथ, फ़िल्टरिंग का समर्थन करता है)
  • श्रेणी संरचना, संगठन योजना और सफाई को समझने के लिए बिल्कुल सही
  • फ़िल्टर उदाहरण: विकास-संबंधित के लिए prefix: "dev", API-संबंधित श्रेणियों के लिए match: "api"

अनुलग्नक

• esa_get_attachment - esa पोस्ट और टिप्पणियों से एक अनुलग्नक फ़ाइल प्राप्त करें
  • 30MB से कम के समर्थित छवियों (JPEG, PNG, GIF, WebP) के लिए बेस64-एन्कोडेड डेटा लौटाता है
  • अन्य फ़ाइल प्रकारों, बड़ी छवियों, या जब forceSignedUrl निर्दिष्ट किया गया हो, के लिए हस्ताक्षरित URL (5 मिनट के लिए वैध) लौटाता है

सहायता और दस्तावेज़ीकरण

• esa_get_search_options_help - esa खोज सिंटैक्स दस्तावेज़ीकरण प्राप्त करें
• esa_get_markdown_syntax_help - esa मार्कडाउन सिंटैक्स दस्तावेज़ीकरण प्राप्त करें
• esa_search_help - सुविधाओं और शब्दावली के लिए esa दस्तावेज़ीकरण खोजें

उपलब्ध संसाधन

• esa_recent_posts - esa टीम से हाल ही में अपडेट की गई पोस्ट प्राप्त करें
  • टेम्पलेट: esa://teams/{teamName}/posts/recent
  • लौटाता है: हाल ही में अपडेट की गई पोस्ट की JSON सूची

उपलब्ध प्रॉम्प्ट

• esa_summarize_post - एक esa पोस्ट सामग्री का सारांश करें
  • इनपुट: टीम का नाम और पोस्ट संख्या
  • आउटपुट: पोस्ट सामग्री का संरचित सारांश

MCP क्लाइंट कॉन्फ़िगरेशन

अपनी MCP क्लाइंट कॉन्फ़िगरेशन फ़ाइल में जोड़ें:

आवश्यक पर्यावरण चर

• ESA_ACCESS_TOKEN: एक्सेस टोकन
  • आवश्यक स्कोप: read write या admin:comment read:post write:post read:category read:tag read:attachment read:team read:member
  • PAT v2 अनुशंसित है।
• LANG: UI के लिए भाषा

Claude डेस्कटॉप उदाहरण

claude_desktop_config.json में जोड़ें:

विकल्प 1: Docker (अनुशंसित)

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_ACCESS_TOKEN",
        "-e",
        "LANG",
        "ghcr.io/esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "your_personal_access_token",
        "LANG": "en"
      }
    }
  }
}

विकल्प 2: npx

{
  "mcpServers": {
    "esa": {
      "command": "/Users/your-username/.nodenv/shims/npx",
      "args": ["@esaio/esa-mcp-server"],
      "env": {
        "ESA_ACCESS_TOKEN": "your_personal_access_token",
        "LANG": "en"
      }
    }
  }
}

नोट: /path/to/your/node को which node कमांड के आउटपुट से बदलें।

रजिस्ट्री

यह पैकेज पैकेज रूट पर registry.json शिप करता है, जो पंजीकृत उपकरणों, संसाधनों और प्रॉम्प्ट को उजागर करता है। इसे सर्वर को स्पॉन किए बिना प्रोग्रामेटिक रूप से उपभोग किया जा सकता है:

import registry from "@esaio/esa-mcp-server/registry.json" with { type: "json" };

स्कीमा:

{
  "tools": [{ "name": "esa_get_teams" }, "..."],
  "resources": [
    { "name": "esa_recent_posts", "uriTemplate": "esa://teams/{teamName}/posts/recent" }
  ],
  "prompts": [{ "name": "esa_summarize_post" }]
}

फ़ाइल npm run build:registry द्वारा पुनर्जीवित की जाती है और एक CI जाँच लागू करती है कि यह पंजीकृत सेट के साथ सिंक में रहे।

लिंक

• esa.io - सहयोगी दस्तावेज़ीकरण प्लेटफ़ॉर्म
• मॉडल कॉन्टेक्स्ट प्रोटोकॉल - MCP के बारे में अधिक जानें
• API दस्तावेज़ीकरण - esa.io API संदर्भ
• Claude डेस्कटॉप - MCP समर्थन वाला AI सहायक

समर्थन

• 📧 समर्थन: प्रतिक्रिया फ़ॉर्म
• 🐛 मुद्दे: GitHub मुद्दे
• 📖 सहायता: esa दस्तावेज़

---

esa टीम द्वारा ❤️ के साथ बनाया गया