ข้ามไปยังเนื้อหาหลัก

ให้เอเจนต์ดูแลรายการสิ่งที่ต้องทำของคุณ

กำลังหา MCP server สำหรับ to-do list ที่ทำงานกับไฟล์จริง แทนที่จะเป็นฐานข้อมูลที่ถูกโฮสต์อยู่ใช่ไหม taskforge มีสิ่งนี้เป็น subcommand คือ taskforge mcp --stdio สำหรับ Vault Obsidian ของคุณ ชี้ Claude Desktop หรือ MCP client ตัวอื่นไปที่มัน แล้วเอเจนต์จะเพิ่ม ค้นหา แก้ไข และทำงานให้เสร็จได้ผ่านชุดเครื่องมือเล็กๆ ชุดหนึ่ง มันทำงานบนเครื่องของคุณเองและแก้ไขไฟล์ Markdown ชุดเดียวกับที่แอปใช้ ไม่มีเซิร์ฟเวอร์ที่ถูกโฮสต์ ไม่มี API key

เร็วๆ นี้ใน TaskForge 3.0

CLI และเซิร์ฟเวอร์ MCP ของ TaskForge จะมาพร้อมกับ TaskForge 3.0 เนื้อหาในหน้านี้อธิบายวิธีการทำงานเมื่อเปิดตัวจริง ส่วนแอป TaskForge นั้นดาวน์โหลดได้แล้ววันนี้

MCP หรือ CLI?

เลือกใช้ MCP tools เมื่อเอเจนต์ของคุณมีการเชื่อมต่อ MCP กับ TaskForge อยู่แล้ว มันมี type ชัดเจน คืนค่า error แบบมีโครงสร้างที่เอเจนต์ใช้แก้ไขตัวเองได้ และไม่ต้องมีอะไรใน PATH ของคุณเลย ส่วน CLI ให้ใช้จาก shell ที่ไม่มีการเชื่อมต่อ MCP เช่น script, cron, CI หรือเอเจนต์เขียนโค้ดที่ทำงานอยู่ใน repo ที่ checkout ไว้ ทั้งสองแบบขับเคลื่อนเอนจินเดียวกันด้วย semantics เดียวกัน จึงเลือกอันไหนที่ runtime ของคุณต่อไว้แล้วก็ได้ การแก้ไฟล์ Vault ด้วยมือคือทางเลือกสุดท้าย

ติดตั้ง

แนะนำ: npx

เพิ่มสิ่งนี้ลงในค่าคอนฟิกของ MCP client ของคุณ npx จะดึง taskforge-md มาให้เองในการรันครั้งแรก จึงไม่ต้องติดตั้งอะไรล่วงหน้า

Claude Desktop คลิกเดียว

อยากได้การติดตั้งแบบมีคำแนะนำใช่ไหม ดาวน์โหลดชุด taskforge (ไฟล์ .mcpb) แล้วเปิดมัน Claude Desktop จะพาคุณตั้งค่าทีละขั้นและถามหาโฟลเดอร์ Vault ของคุณ

พร้อมใช้งานเมื่อเปิดตัว
{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

คอมไพล์ taskforge เองจาก source แทนที่จะใช้ npx ใช่ไหม ให้ชี้คอนฟิกไปที่ไบนารีโดยตรง:

พร้อมใช้งานเมื่อเปิดตัว
"command": "taskforge",
"args": ["mcp", "--stdio"]

ใช้ได้เฉพาะบนเดสก์ท็อป เพราะนั่นคือที่ที่ MCP client อาศัยอยู่ taskforge มาในรูปไบนารีเนทีฟตัวเดียวสำหรับ macOS, Windows และ Linux โดย MCP server เป็นหนึ่งใน subcommand ของมัน

ชุดเครื่องมือทั้งหมด

มีทั้งหมด 22 เครื่องมือ ครอบคลุมวงจรชีวิตของงานทั้งหมด ได้แก่ สร้าง อ่าน อัปเดต ทำเสร็จ เก็บถาวร และลบ แต่ละอย่างมีเวอร์ชันทำทีละหลายรายการด้วย นอกจากนี้ยังมีการย้าย การเปลี่ยนงานแม่ และการแปลงระหว่างบรรทัดแบบ inline กับไฟล์ TaskNotes การตรวจสอบ lint ก่อนเขียนบรรทัด การเรียก doctor เพื่อตรวจสุขภาพ vault และ resource ของ schema กับรายการ เพื่อให้เอเจนต์เรียนรู้รูปแบบของคุณก่อนลงมือทำ หกอย่างด้านล่างคือสิ่งที่คุณจะใช้บ่อยที่สุด ทุกการเรียกจะอ่าน vault จากดิสก์ใหม่เสมอ เอเจนต์จึงทำงานกับไฟล์ล่าสุดอยู่เสมอ

query_tasks ค้นหาและกรองงาน หรืออ่านรายการที่บันทึกไว้ อ่านได้อย่างเดียว อ่านได้อย่างเดียว
get_task อ่านงานหนึ่งงานพร้อม content hash ของมัน อ่านได้อย่างเดียว อ่านได้อย่างเดียว
add_task สร้างงานในเป้าหมายเริ่มต้นของ Vault ตามรูปแบบของคุณ เขียนได้
update_task เปลี่ยนสถานะ ลำดับความสำคัญ วันครบกำหนด ชื่อ หรือแท็กของงาน เขียนได้
complete_task ทำงานให้เสร็จ คืนค่าการเกิดครั้งถัดไปถ้างานนั้นเกิดซ้ำ เขียนได้ ไม่ใช่ idempotent
delete_task ลบงาน โมเดลต้องพิมพ์ชื่อปัจจุบันของงานกลับมาให้ตรงเป๊ะ เพื่อป้องกันการทำงานกับ id ที่เก่าแล้วหรือถูกสร้างขึ้นมาเอง (hallucinated) ทำลายข้อมูล

ตอนนี้แต่ละเครื่องมือมี annotation กำกับไว้ ทำให้ไคลเอนต์รู้ได้ทันทีว่าการเรียกไหนอ่านอย่างเดียว ไหนเขียน และไหนลบ ส่วนที่เหลือของชุดเครื่องมือยังมี 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_task_lists และ get_schema

สามรีซอร์ส

นอกจากเครื่องมือแล้ว เซิร์ฟเวอร์ยังเปิดให้เข้าถึงบริบทแบบอ่านอย่างเดียว เพื่อให้เอเจนต์เรียนรู้กฎของ Vault คุณก่อนที่จะลงมือทำ:

taskforge://schema สำเนียงงานในรูปแบบที่เครื่องอ่านได้ ได้แก่สัญลักษณ์สถานะ รูปแบบวันที่ ฟิลด์ที่กำหนดเอง และเป้าหมายการเขียน
taskforge://agents-guide คู่มือภาษาธรรมดาที่อธิบายข้อกำหนดของงานใน Vault คุณ
taskforge://lists รายการงานที่คุณบันทึกไว้ และวิธีเพิ่มงานลงในแต่ละรายการ

ข้อกำหนดเดียว: สัญญาของ Vault

เซิร์ฟเวอร์อ่านไฟล์สัญญาที่ TaskForge เขียนลงใน Vault ของคุณ คือ taskforge/schema.json และ taskforge/agents.md เพื่อเรียนรู้รูปแบบงานที่ตรงกับ Vault นี้เป๊ะๆ เปิด Vault ใน TaskForge 3.0 ขึ้นไปอย่างน้อยหนึ่งครั้ง ไปที่ Settings, AI & Agents แล้วเปิด "Generate agent files" ทิ้งไว้ ถ้า Vault ไม่เคยถูกเปิดในบิลด์ล่าสุดเลย เซิร์ฟเวอร์จะใช้ค่าเริ่มต้นทั่วไปแทน และแจ้งเตือนไคลเอนต์

ถ้ามันหา Vault ของคุณไม่เจอ

เซิร์ฟเวอร์เริ่มทำงานเสมอ แม้จะยังไม่รู้ว่า Vault ของคุณอยู่ที่ไหน ดังนั้น Claude Desktop จะไม่มีวันแสดง "server failed to start" แบบไม่ชัดเจน เมื่อการเรียกเครื่องมือหา Vault ไม่เจอ มันจะคืนข้อผิดพลาดที่เป็นข้อความธรรมดาให้เอเจนต์ส่งต่อได้ ได้แก่ ตั้งค่าตัวแปรสภาพแวดล้อม TASKFORGE_VAULT ให้เป็นพาธของ Vault คุณ หรือติดตั้งบันเดิลใหม่แล้วป้อนไดเรกทอรี Vault เมื่อถูกถาม

ทำงานในเครื่องเท่านั้น

taskforge mcp --stdio อ่านและเขียนเฉพาะไฟล์ Markdown ใน Vault ที่คุณกำหนดค่าไว้เท่านั้น ไม่มีบัญชี ไม่มีคลาวด์ ระบบซิงค์ที่คุณใช้อยู่แล้ว ไม่ว่าจะเป็น iCloud, Dropbox หรือ Obsidian Sync จะย้ายการเปลี่ยนแปลงระหว่างอุปกรณ์ให้เอง

ชอบใช้เทอร์มินัลมากกว่าไหม?

ถ้าคุณอยากเขียนสคริปต์จัดการงาน หรือรันคำสั่งครั้งเดียวแทนที่จะให้เอเจนต์เป็นคนควบคุม taskforge CLI ก็ครอบคลุม Vault เดียวกันด้วยกฎเดียวกัน

ติดตั้ง taskforge CLI →

คำถามที่คนถามบ่อย

MCP server ของ taskforge คืออะไร

มันคือ Model Context Protocol server ในเครื่องที่ฝังอยู่ในไบนารี taskforge รันด้วย taskforge mcp --stdio แล้ว MCP client อย่าง Claude Desktop จะเพิ่ม ค้นหา แก้ไข ย้าย ทำงานให้เสร็จ และลบงานใน Obsidian vault ของคุณได้ผ่านเครื่องมือที่มี type ชัดเจนถึง 22 อย่าง ทั้งแบบทีละรายการหรือทำทีละหลายรายการ มันคือรายการสิ่งที่ต้องทำที่เอเจนต์ของคุณลงมือทำได้ ไม่ใช่แค่อ่าน

ใช้กับ MCP client ตัวไหนได้บ้าง

ไคลเอนต์ไหนก็ได้ที่คุย MCP ผ่าน stdio Claude Desktop คือตัวที่พบบ่อยที่สุด และ Claude Code, Cursor และ VS Code (สำหรับ GitHub Copilot) ก็ใช้คอนฟิกเดียวกันได้หมด แต่ละตัวได้เครื่องมือ 22 อย่างและรีซอร์สสามอย่างเหมือนกัน

นี่เป็น MCP server ที่ถูกโฮสต์หรือเป็นแบบ remote ไหม

ไม่ มันทำงานบนเครื่องของคุณผ่าน stdin และ stdout และแตะแค่โฟลเดอร์ Vault ที่คุณชี้ให้เท่านั้น ไม่มี URL ให้โฮสต์ ไม่มี API key และไม่มีบัญชี TaskForge นั่นคือประเด็นสำคัญ: รายการสิ่งที่ต้องทำของคุณอยู่บนดิสก์ของคุณเอง

ฉันต้องติดตั้งอะไรก่อนไหม

ไม่ต้องเตรียมล่วงหน้า ชี้คอนฟิกของไคลเอนต์คุณไปที่ npx -y taskforge-md mcp --stdio แล้ว npx จะดึงแพ็กเกจมาให้เองในการรันครั้งแรก ผู้ใช้ Claude Desktop เปิดไฟล์ .mcpb แทนได้ เพื่อการติดตั้งแบบมีคำแนะนำ

ไคลเอนต์บอกว่าหา Vault ของฉันไม่เจอ ต้องทำยังไง

เซิร์ฟเวอร์เริ่มทำงานเสมอ ไคลเอนต์จึงไม่มีวันแสดง "failed to start" แบบไม่ชัดเจน เมื่อการเรียกเครื่องมือหา Vault ไม่เจอ มันจะคืนข้อความธรรมดาให้: ตั้งค่าตัวแปรสภาพแวดล้อม TASKFORGE_VAULT ให้เป็นพาธของ Vault คุณ หรือติดตั้งบันเดิลใหม่แล้วป้อนไดเรกทอรี Vault เมื่อถูกถาม

มันต้องใช้ไฟล์สัญญาของ Vault ไหม

ต้องใช้ เพื่อให้ตรงกับรูปแบบของคุณ มันอ่าน taskforge/schema.json และ taskforge/agents.md ซึ่งถูกสร้างขึ้นเมื่อคุณเปิด Vault ใน TaskForge 3.0 ขึ้นไปโดยเปิด "Generate agent files" ไว้ ถ้าไม่มีไฟล์เหล่านี้ มันก็ยังทำงานได้ แต่จะย้อนกลับไปใช้ค่าเริ่มต้นทั่วไปและแจ้งเตือนไคลเอนต์ว่ากำลังเดาอยู่

เอเจนต์ลงมือทำตามรายการ แอปเป็นคนดูแลรายการนั้น

MCP server เขียนลง Vault ของคุณ ส่วน TaskForge เปลี่ยนไฟล์เหล่านั้นให้เป็นรายการ วิดเจ็ต และการแจ้งเตือนในทุกอุปกรณ์ของคุณ ดาวน์โหลดฟรีบน iPhone, iPad, Mac และ Android