Máy chủ “Obsidian” MCP làm gì?

Máy chủ Obsidian MCP là một trình kết nối cho phép Claude Desktop—hoặc bất kỳ client Model Context Protocol (MCP) nào—đọc và tìm kiếm các thư mục chứa ghi chú Markdown, chẳng hạn như trong kho Obsidian. Máy chủ này tạo cầu nối giữa trợ lý AI và kho kiến thức cá nhân hoặc nhóm của bạn lưu trữ dưới dạng Markdown, giúp dễ dàng truy cập, tìm kiếm và sử dụng ghi chú trong quy trình phát triển. Bằng cách tích hợp với các nguồn dữ liệu bên ngoài như Obsidian, máy chủ trao quyền cho các công cụ AI thực hiện các tác vụ như tìm kiếm thông tin, truy xuất ghi chú cụ thể hoặc tóm tắt nội dung, từ đó nâng cao năng suất và quản lý tri thức cho lập trình viên và người làm việc với kiến thức.

Danh sách Prompt

Không có mẫu prompt nào được đề cập rõ ràng trong tài liệu đã cung cấp.

Danh sách Tài nguyên

Không có tài nguyên cụ thể nào được trình bày trong tài liệu.

Danh sách Công cụ

Từ tài liệu và hình ảnh có sẵn, sau khi cài đặt, các công cụ sau được liệt kê (dù không được mô tả trong mã):

• Đọc Ghi Chú: Cho phép đọc nội dung của một ghi chú cụ thể trong kho Obsidian.
• Tìm kiếm Ghi Chú: Cho phép tìm kiếm các ghi chú trong kho dựa trên từ khóa hoặc truy vấn.

Lưu ý: Tên công cụ và mô tả được suy ra từ tài liệu và hình ảnh có sẵn; chi tiết thêm chưa được chỉ rõ.

Ứng dụng của Máy chủ MCP này

• Quản lý tri thức cá nhân: Dễ dàng tìm kiếm, đọc và truy xuất thông tin từ kho Obsidian cá nhân bằng Claude Desktop, giúp ghi chú của bạn dễ dàng truy cập cho LLM tóm tắt hoặc trả lời câu hỏi.
• Tìm kiếm tài liệu nhóm: Tích hợp các thư mục Markdown dùng chung làm nguồn tài nguyên tìm kiếm cho thành viên nhóm hoặc trợ lý AI, nâng cao chia sẻ kiến thức và hỗ trợ hội nhập nhân sự mới.
• Hỗ trợ AI theo ngữ cảnh: Cung cấp thông tin liên quan từ ghi chú của bạn làm ngữ cảnh cho LLM, tăng độ phù hợp và chính xác cho phản hồi AI trong quá trình phát triển hoặc nghiên cứu.
• Tự động tóm tắt ghi chú: Dùng AI để tóm tắt các ghi chú hoặc tài liệu dài trong kho Obsidian, tiết kiệm thời gian tổng hợp thủ công.

Cách thiết lập

Windsurf

1. Đảm bảo Node.js và Windsurf đã được cài đặt.
2. Mở tệp cấu hình Windsurf của bạn.
3. Thêm nội dung sau vào phần mcpServers:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Lưu tệp và khởi động lại Windsurf.
5. Xác minh máy chủ MCP đang chạy và có thể truy cập.

Claude

1. Đảm bảo Claude Desktop và Node.js đã được cài đặt.
2. Cài đặt Obsidian MCP bằng Smithery:

   npx @smithery/cli install mcp-obsidian --client claude
   

3. Khởi động lại Claude Desktop.
4. Xác nhận các công cụ Obsidian MCP xuất hiện trong giao diện Claude Desktop.

Cursor

1. Đảm bảo Node.js và Cursor đã được cài đặt.
2. Mở tệp cấu hình Cursor của bạn.
3. Thêm máy chủ Obsidian MCP như sau:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Lưu và khởi động lại Cursor.
5. Kiểm tra danh sách công cụ của Cursor để xác nhận có máy chủ Obsidian MCP.

Cline

1. Cài đặt Node.js và Cline.
2. Chỉnh sửa tệp cấu hình Cline của bạn.
3. Thêm máy chủ Obsidian MCP:

   {
     "obsidian": {
       "command": "npx",
       "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"]
     }
   }
   

4. Lưu cấu hình và khởi động lại Cline.
5. Kiểm tra cấu hình bằng cách xác nhận Obsidian MCP xuất hiện trong giao diện.

Bảo mật API Key

Nếu máy chủ Obsidian MCP hoặc kho của bạn cần xác thực hoặc API key, hãy sử dụng biến môi trường để bảo mật:

{
  "obsidian": {
    "command": "npx",
    "args": ["-y", "mcp-obsidian", "<path-to-your-vault>"],
    "env": {
      "OBSIDIAN_API_KEY": "${env:OBSIDIAN_API_KEY}"
    },
    "inputs": {
      "vaultPath": "<path-to-your-vault>"
    }
  }
}

Cách sử dụng MCP này trong flow

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào workflow FlowHunt của bạn, hãy bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối nó với agent AI của bạn:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, hãy chèn thông tin máy chủ MCP của bạn sử dụng định dạng JSON này:

{
  "obsidian": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình xong, agent AI có thể sử dụng MCP này như một công cụ với quyền truy cập đầy đủ các chức năng. Lưu ý đổi “obsidian” thành tên thực tế của máy chủ MCP và thay URL bằng địa chỉ máy chủ MCP của bạn.

Tổng quan

Dựa vào các yếu tố trên, máy chủ Obsidian MCP rất đơn giản và dễ thiết lập để tìm kiếm và lấy ghi chú Obsidian, nhưng thiếu mẫu prompt chi tiết, định nghĩa tài nguyên rõ ràng và các tính năng MCP nâng cao như sampling hoặc roots. Tuy nhiên, nó vẫn cung cấp các công cụ thiết yếu để giúp ghi chú Obsidian có thể truy cập bằng AI.

Điểm MCP

Với mục tiêu rõ ràng, dễ cài đặt, và hữu ích cho người dùng Obsidian, tôi đánh giá máy chủ MCP này ở mức 6/10. Nó phù hợp với mục đích sử dụng nhưng còn thiếu các tính năng MCP nâng cao và chiều sâu tài liệu cho khả năng mở rộng rộng hơn.