esa MCP Server

आधिकारिक

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

Esa MCP के साथ आप क्या कर सकते हैं?

  • पोस्ट खोजें और पढ़ें — esa_search_posts से पोस्ट खोजें, फिर किसी खास पोस्ट का बैकलिंक काउंट और बॉडी के आँकड़े देखने के लिए उसके नंबर से esa_get_post का उपयोग करके उसे प्राप्त करें।
  • कंटेंट बनाएँ और संपादित करें — esa_create_post से पोस्ट बनाएँ, esa_update_post से उन्हें अपडेट करें, या esa_append_post और esa_prepend_post का उपयोग करके टेक्स्ट जोड़ें।
  • पोस्ट का जीवनचक्र प्रबंधित करें — esa_ship_post से पोस्ट प्रकाशित करें, esa_archive_post से उसे संग्रहित करें, esa_duplicate_post से उसकी प्रतिलिपि बनाएँ, या किसी पुराने संशोधन पर वापस जाएँ।
  • टिप्पणियाँ संभालें — किसी पोस्ट या टीम की टिप्पणियाँ सूचीबद्ध करें, फिर esa_create_comment, esa_update_comment और esa_delete_comment से उन्हें बनाएँ, अपडेट करें या हटाएँ।
  • श्रेणियाँ और टीमें देखें — esa_get_all_category_paths से श्रेणी पथ ब्राउज़ करें और esa_get_team_stats तथा esa_get_team_members से टीम का विवरण देखें।
  • पोस्ट का सारांश बनाएँ — किसी टीम की पोस्ट का संरचित सारांश पाने के लिए esa_summarize_post प्रॉम्प्ट का उपयोग करें।

दस्तावेज़

esa MCP Server

License: MIT

日本語 | अंग्रेज़ी

esa.io के लिए आधिकारिक Model Context Protocol (MCP) सर्वर - STDIO ट्रांसपोर्ट संस्करण।

अवलोकन

यह MCP सर्वर AI सहायकों और esa.io, एक सहयोगी दस्तावेज़ीकरण प्लेटफ़ॉर्म, के बीच सहज एकीकरण प्रदान करता है। यह AI सहायकों को Model Context Protocol के माध्यम से सीधे 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 - पोस्ट को Archived/ श्रेणी में ले जाकर संग्रहित करें
  • esa_ship_post - पोस्ट को पूर्ण चिह्नित करके शिप करें (wip को false पर सेट करके)
  • esa_duplicate_post - पोस्ट की प्रतिलिपि बनाएँ (समान शीर्षक और बॉडी वाली नई WIP पोस्ट बनाएँ; टीमों के बीच प्रतिलिपि बनाना भी समर्थित है)
  • esa_rollback_post_revision - पोस्ट को निर्दिष्ट संशोधन पर वापस लाएँ (पुनर्स्थापित सामग्री नए संशोधन के रूप में सहेजी जाती है; संशोधन संख्या esa_get_post में revision_number के माध्यम से देखें)

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

  • 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) के लिए base64-एन्कोड किया गया डेटा लौटाता है
    • अन्य फ़ाइल प्रकारों, बड़ी छवियों या forceSignedUrl निर्दिष्ट होने पर हस्ताक्षरित URL लौटाता है (5 मिनट तक मान्य)

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

  • esa_get_search_options_help - esa खोज सिंटैक्स का दस्तावेज़ीकरण प्राप्त करें
  • esa_get_markdown_syntax_help - esa Markdown सिंटैक्स का दस्तावेज़ीकरण प्राप्त करें
  • 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 Desktop का उदाहरण

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 - सहयोगी दस्तावेज़ीकरण प्लेटफ़ॉर्म
  • Model Context Protocol - MCP के बारे में अधिक जानें
  • API Documentation - esa.io API संदर्भ
  • Claude Desktop - MCP समर्थन वाला AI सहायक

सहायता


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