Chris CoutinhoandClaude Opus 4.8
3074622455
Add read-only support for the Nextcloud Mail app, plus semantic indexing of mail messages. The MCP server never speaks IMAP/POP3 itself: it calls the Mail app's CSRF-free OCS API (/ocs/v2.php/apps/mail/api/...) with the existing Basic-Auth app-password flow and an OCS-APIRequest header, and the Mail app handles IMAP server-side. - client/mail.py: MailClient (accounts, mailboxes, messages, message, attachment), OCS-envelope aware. - models/mail.py: Pydantic models with the API's camelCase aliases. - server/mail.py: 5 read-only MCP tools (mail.read scope), registered in AVAILABLE_APPS. - Vector pipeline: new "mail_message" doc_type wired into scanner (scan_mail_messages, newest-N per mailbox), processor (body -> markdown embedding), per-id verifier, and context expansion. - Tests: client API, model round-trips, verifier behavior; consent-backstop test now derives its allowed set from INDEXED_DOC_TYPES. - README + semantic-search docstrings updated. Requires Mail 5.x / Nextcloud 32+ and a mail account configured in the Mail app. Follow-up: astrolabe must advertise "mail_message" in its enabled_doc_types capability for search under admin doc_type restriction. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
54 lines
1.8 KiB
Python
54 lines
1.8 KiB
Python
from collections.abc import Callable
|
|
|
|
from mcp.server.fastmcp import FastMCP
|
|
|
|
from .calendar import configure_calendar_tools
|
|
from .collectives import configure_collectives_tools
|
|
from .contacts import configure_contacts_tools
|
|
from .cookbook import configure_cookbook_tools
|
|
from .deck import configure_deck_tools
|
|
from .mail import configure_mail_tools
|
|
from .news import configure_news_tools
|
|
from .notes import configure_notes_tools
|
|
from .semantic import configure_semantic_tools
|
|
from .sharing import configure_sharing_tools
|
|
from .tables import configure_tables_tools
|
|
from .talk import configure_talk_tools
|
|
from .webdav import configure_webdav_tools
|
|
|
|
# Canonical mapping of app name → tool registration function.
|
|
# Used by app.py (HTTP), stdio.py (stdio), and cli.py (--enable-app choices).
|
|
# Semantic search is excluded here because it is a cross-app feature gated
|
|
# by VECTOR_SYNC_ENABLED, not an individual Nextcloud app.
|
|
AVAILABLE_APPS: dict[str, Callable[[FastMCP], None]] = {
|
|
"notes": configure_notes_tools,
|
|
"tables": configure_tables_tools,
|
|
"webdav": configure_webdav_tools,
|
|
"sharing": configure_sharing_tools,
|
|
"calendar": configure_calendar_tools,
|
|
"collectives": configure_collectives_tools,
|
|
"contacts": configure_contacts_tools,
|
|
"cookbook": configure_cookbook_tools,
|
|
"deck": configure_deck_tools,
|
|
"news": configure_news_tools,
|
|
"mail": configure_mail_tools,
|
|
"talk": configure_talk_tools,
|
|
}
|
|
|
|
__all__ = [
|
|
"AVAILABLE_APPS",
|
|
"configure_calendar_tools",
|
|
"configure_collectives_tools",
|
|
"configure_contacts_tools",
|
|
"configure_cookbook_tools",
|
|
"configure_deck_tools",
|
|
"configure_mail_tools",
|
|
"configure_news_tools",
|
|
"configure_notes_tools",
|
|
"configure_semantic_tools",
|
|
"configure_sharing_tools",
|
|
"configure_tables_tools",
|
|
"configure_talk_tools",
|
|
"configure_webdav_tools",
|
|
]
|