किसी एजेंट को अपनी कार्य-सूची चलाने दें

ऐसे todo MCP सर्वर की तलाश में हैं जो होस्टेड डेटाबेस की बजाय असली फ़ाइलों पर काम करे? taskforge इसे सबकमांड के रूप में देता है, taskforge mcp --stdio, आपके Obsidian वॉल्ट के लिए। Claude Desktop या किसी और MCP क्लाइंट को इसकी ओर इशारा करें, और एजेंट टूल के एक छोटे सेट के ज़रिए कार्य जोड़ता है, खोजता है, संपादित करता है और पूरा करता है। यह आपकी मशीन पर चलता है और वही Markdown फ़ाइलें संपादित करता है जो ऐप करता है। न कोई होस्टेड सर्वर, न कोई API key।

MCP या CLI?

जब आपके एजेंट का TaskForge से पहले से MCP कनेक्शन हो, तो MCP टूल को प्राथमिकता दें। ये टाइप किए हुए होते हैं, ऐसी संरचित त्रुटियाँ लौटाते हैं जिनसे एजेंट खुद को सुधार सके, और आपके PATH में कुछ भी नहीं चाहिए। जहाँ MCP कनेक्शन नहीं है, ऐसे शेल संदर्भों में, जैसे स्क्रिप्ट, cron, CI, या रिपॉजिटरी चेकआउट में काम करने वाला कोडिंग एजेंट, इसकी बजाय CLI अपनाएं। दोनों एक ही इंजन को एक जैसे व्यवहार के साथ चलाते हैं, इसलिए जो आपके रनटाइम में पहले से जुड़ा है उसे चुनें। वॉल्ट फ़ाइलों को हाथ से बदलना आखिरी विकल्प है।

इंस्टॉल करें

अनुशंसित: npx

पहले npm और npx के साथ Node.js इंस्टॉल करें, फिर इसे अपने MCP क्लाइंट के कॉन्फ़िग में जोड़ें। npx पहली बार चलने पर taskforge-md डाउनलोड कर लेता है।

Claude Desktop, एक क्लिक में

गाइडेड इंस्टॉल पसंद करते हैं? taskforge बंडल (.mcpb फ़ाइल) डाउनलोड करें और उसे खोलें। Claude Desktop आपको पूरी सेटअप प्रक्रिया से गुज़ारता है और आपका वॉल्ट फ़ोल्डर माँगता है।

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

Windows पर npx से पहले cmd /c लगाएँ। Claude Desktop जैसे डेस्कटॉप MCP क्लाइंट सर्वर को बिना शेल के शुरू करते हैं, और npx एक .cmd स्क्रिप्ट है जिसे Windows केवल शेल के ज़रिए चलाता है:

{
  "mcpServers": {
    "taskforge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "C:\\path\\to\\your\\vault"
      }
    }
  }
}

npx की जगह taskforge को सोर्स से बिल्ड किया है? कॉन्फ़िग को सीधे बाइनरी की ओर इशारा करें:

"command": "taskforge",
"args": ["mcp", "--stdio"]

सिर्फ़ डेस्कटॉप के लिए, क्योंकि MCP क्लाइंट वहीं होते हैं। taskforge macOS और Windows के लिए एक ही नेटिव बाइनरी के रूप में उपलब्ध है, और MCP सर्वर उसके सबकमांड में से एक है। Linux संस्करण जल्द आ रहा है।

पूरा टूल सेट

कुल 30 टूल हैं, जो कार्य और नोट के पूरे जीवनचक्र को कवर करते हैं: बनाना, पढ़ना, अपडेट करना, पूरा करना, संग्रह में रखना और हटाना, हर एक का बल्क रूप भी; ले जाना, नया मूल कार्य तय करना, और इनलाइन पंक्ति व कार्य फ़ाइल के बीच बदलना; लिंक तोड़े बिना नोट बनाना, उनका नाम बदलना, हटाना और संपादित करना; पंक्ति लिखने से पहले एक लिंट जाँच; वॉल्ट की सेहत जाँचने के लिए एक डॉक्टर कॉल; और डायलेक्ट व स्पेस रिसोर्स, ताकि एजेंट काम करने से पहले आपका फ़ॉर्मैट सीख ले। नीचे दिए छह वे हैं जिनकी आपको सबसे ज़्यादा ज़रूरत पड़ेगी। हर कॉल वॉल्ट को डिस्क से फिर से पढ़ती है, इसलिए एजेंट हमेशा मौजूदा फ़ाइलों पर काम करता है।

query_tasks	कार्यों को खोजें और फ़िल्टर करें, या कोई सहेजी गई सूची पढ़ें। केवल पढ़ने के लिए।	केवल पढ़ने के लिए
get_task	एक कार्य और उसका कंटेंट हैश पढ़ें। केवल पढ़ने के लिए।	केवल पढ़ने के लिए
add_task	वॉल्ट के डिफ़ॉल्ट टार्गेट में, आपके फ़ॉर्मेट में एक कार्य बनाएं।	लिखता है
update_task	किसी कार्य की स्थिति, प्राथमिकता, नियत तारीख़, शीर्षक, या टैग बदलें।	लिखता है
complete_task	एक कार्य पूरा करें; अगर वह आवर्ती है तो अगली आवृत्ति लौटाता है।	लिखता है, idempotent नहीं
delete_task	एक कार्य हटाएं। मॉडल को उसका ठीक मौजूदा शीर्षक वापस दोहराना ज़रूरी है, यह किसी पुराने या हैलुसिनेटेड id पर काम करने से बचाव करता है।	विनाशकारी

हर टूल में एनोटेशन होते हैं, ताकि किसी क्लाइंट को एक नज़र में पता चल जाए कि कौन सी कॉल सिर्फ़ पढ़ती हैं, कौन सी लिखती हैं, और कौन सी हटाती है। बाकी सेट में bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_spaces, get_dialect, create_note, read_note, update_note, patch_note_block, patch_note_frontmatter, normalize_references, delete_note और move_note शामिल हैं।

तीन रिसोर्स

टूल के साथ-साथ, सर्वर केवल पढ़ने योग्य संदर्भ भी उपलब्ध कराता है ताकि एजेंट काम करने से पहले आपके वॉल्ट के नियम सीख ले:

taskforge://dialect	मशीन से पढ़ी जा सकने वाली कार्य बोली: स्थिति चिह्न, तारीख़ फ़ॉर्मेट, कस्टम फ़ील्ड, लिखने के लक्ष्य।
taskforge://agents-guide	आपके वॉल्ट की कार्य परंपराओं की सादी भाषा में गाइड।
taskforge://spaces	आपके सहेजे गए स्पेस और हर एक में कार्य कैसे जोड़ें।

एक ज़रूरत: वॉल्ट कॉन्ट्रैक्ट

सर्वर वे कॉन्ट्रैक्ट फ़ाइलें पढ़ता है जो TaskForge आपके वॉल्ट में लिखता है, TaskForge/Settings/dialect.json और TaskForge/Settings/agents.md, ताकि आपका सटीक कार्य फ़ॉर्मेट सीख सके। TaskForge 3.0 या उसके बाद के वर्शन में वॉल्ट को कम से कम एक बार खोलें, सेटिंग्स, AI और एजेंट पर जाएं, और "एजेंट फ़ाइलें जनरेट करें" को चालू रहने दें। अगर वॉल्ट किसी हाल के बिल्ड में कभी नहीं खोला गया, तो सर्वर सामान्य डिफ़ॉल्ट पर वापस चला जाता है और क्लाइंट को चेतावनी देता है। ये पाथ डिफ़ॉल्ट बेस फ़ोल्डर के हैं; अगर आपने उसका नाम बदला है, तो उसकी जगह वही फ़ोल्डर इस्तेमाल करें।

अगर इसे आपका वॉल्ट नहीं मिलता

सर्वर हमेशा शुरू होता है, यहाँ तक कि इससे पहले भी कि उसे पता हो कि आपका वॉल्ट कहाँ है, इसलिए Claude Desktop कभी कोई अस्पष्ट "server failed to start" नहीं दिखाता। जब कोई टूल कॉल वॉल्ट का पता नहीं लगा पाती, तो यह एक सादी त्रुटि लौटाता है जिसे एजेंट आगे बता सके: TASKFORGE_VAULT एनवायरनमेंट वेरिएबल को अपने वॉल्ट पथ पर सेट करें, या बंडल दोबारा इंस्टॉल करें और पूछे जाने पर वॉल्ट डायरेक्टरी दर्ज करें।

सिर्फ़ लोकल

TaskForge MCP सर्वर लोकल चलता है और आपके वॉल्ट की Markdown फ़ाइलें पढ़ता-लिखता है। npx से इंस्टॉल करने पर पैकेज npm से डाउनलोड होता है। आपका AI क्लाइंट टूल के इनपुट और नतीजे अपने प्रदाता को भेज सकता है; उसकी गोपनीयता सेटिंग्स तब भी लागू रहती हैं। आपका मौजूदा वॉल्ट सिंक डिवाइसों के बीच बदलाव पहुँचाता है।

टर्मिनल पसंद है?

अगर आप अपने कार्यों को स्क्रिप्ट करना चाहते हैं या किसी एजेंट से चलवाने की बजाय एक-बार के कमांड चलाना चाहते हैं, तो taskforge CLI उसी वॉल्ट को उन्हीं नियमों के साथ संभालता है।

taskforge CLI इंस्टॉल करें →

लोग जो सवाल पूछते हैं

taskforge MCP सर्वर क्या है?

यह taskforge बाइनरी में बना एक लोकल Model Context Protocol सर्वर है। इसे taskforge mcp --stdio से चलाएं, और Claude Desktop जैसा कोई MCP क्लाइंट 30 टाइप किए गए टूल के ज़रिए, अकेले या बल्क में, आपके Obsidian वॉल्ट में कार्य और नोट जोड़, खोज, संपादित, मूव, पूरा और हटा सकता है। यह एक ऐसी कार्य-सूची है जिस पर आपका एजेंट काम कर सकता है, सिर्फ़ पढ़ नहीं सकता।

यह किन MCP क्लाइंट के साथ काम करता है?

किसी भी क्लाइंट के साथ जो stdio पर MCP बोलता है। Claude Desktop सबसे आम है, और Claude Code, Cursor, तथा (GitHub Copilot के लिए) VS Code, सभी वही कॉन्फ़िग लेते हैं। हर एक को वही 30 टूल और तीन रिसोर्स मिलते हैं।

क्या यह होस्टेड या रिमोट MCP सर्वर है?

नहीं। यह आपकी मशीन पर stdin और stdout के ज़रिए चलता है और सिर्फ़ उस वॉल्ट फ़ोल्डर को छूता है जिसकी ओर आप इसे इशारा करते हैं। न कोई होस्ट करने के लिए URL, न कोई API key, न कोई TaskForge अकाउंट। यही तो बात है: आपकी कार्य-सूची आपकी डिस्क पर ही रहती है।

क्या मुझे पहले से कुछ इंस्टॉल करना होगा?

npx सेटअप के लिए npm और npx के साथ Node.js चाहिए। फिर आपका क्लाइंट सर्वर को लाने और शुरू करने के लिए npx -y taskforge-md mcp --stdio चला सकता है। Claude Desktop उपयोगकर्ता इसकी जगह नेटिव .mcpb बंडल खोल सकते हैं, जिसके लिए Node.js ज़रूरी नहीं है।

क्लाइंट कहता है कि सर्वर को मेरा वॉल्ट नहीं मिल रहा। अब क्या करें?

सर्वर हमेशा शुरू होता है, इसलिए क्लाइंट कभी कोई अस्पष्ट "failed to start" नहीं दिखाता। जब कोई टूल कॉल वॉल्ट का पता नहीं लगा पाती, तो यह एक सादा संदेश लौटाता है: TASKFORGE_VAULT एनवायरनमेंट वेरिएबल को अपने वॉल्ट पथ पर सेट करें, या बंडल दोबारा इंस्टॉल करें और पूछे जाने पर वॉल्ट डायरेक्टरी दर्ज करें।

क्या इसे वॉल्ट कॉन्ट्रैक्ट फ़ाइलों की ज़रूरत है?

हां, आपके फ़ॉर्मेट से मेल खाने के लिए। यह TaskForge/Settings/dialect.json और TaskForge/Settings/agents.md पढ़ता है, जो "एजेंट फ़ाइलें जनरेट करें" चालू रखते हुए TaskForge 3.0 या उसके बाद के वर्शन में वॉल्ट खोलने पर बनती हैं। इनके बिना भी यह चलता है, लेकिन सामान्य डिफ़ॉल्ट पर वापस चला जाता है और क्लाइंट को चेतावनी देता है कि यह अंदाज़ा लगा रहा है।

एजेंट सूची पर काम करता है। ऐप उसे संभालता है।

MCP सर्वर आपके वॉल्ट में लिखता है; TaskForge उन फ़ाइलों को आपकी सभी डिवाइसों पर सूचियों, विजेट और रिमाइंडर में बदल देता है। iPhone, iPad, Mac, Android और Windows पर मुफ़्त डाउनलोड के लिए उपलब्ध।

डाउनलोड करें Windows

सूचना पाएँ Linux