MCP 工具
本文档是 MCP tool 文档入口。当前仓库已实现 src/nilo/mcp_server/，使用 MCP Python SDK 的 FastMCP 暴露本地工具。
Server
- server factory：
src/nilo/mcp_server/server.py - package entry：
nilo.mcp_server:create_mcp_server - CLI stdio entry：
nilo server stdio - CLI background HTTP entry：
nilo server run --host 127.0.0.1 --port 8000 - 支持 transport：
stdio、streamable-http
工具域文档
config.mdauth.mdpages.mdblocks.mddatabases.mddata_sources.mdusers.mdcomments.mdviews.mdfile_uploads.mdsearch.mdcustom_emojis.mdraw_api.md
Tool Inventory
当前 server 可枚举 46 个 tools：
auth_validateauth_whoamiblock_appendblock_children_listblock_trashblock_updatecomment_createcomment_listcomment_replyconfig_getconfig_statuscustom_emoji_listcustom_emoji_retrievedata_source_createdata_source_property_renamedata_source_querydata_source_retrievedata_source_templatesdata_source_updatedatabase_createdatabase_querydatabase_renamedatabase_retrievedatabase_sourcesdatabase_updatefile_upload_completefile_upload_createfile_upload_listfile_upload_retrievefile_upload_sendpage_createpage_property_retrievepage_retrievepage_trashpage_updateraw_api_invokeraw_api_registered_operationssearchuser_listuser_meuser_retrieveview_createview_listview_queryview_retrieveview_update
公共规则
- MCP Tool 只能调用 Core，不能调用 CLI。
- 工具错误应返回结构化
{"ok": false, "error": ...}。 - token 默认必须脱敏。
- 删除、归档、trash 类危险工具必须带
destructiveHint，并要求confirm=true。 - live Notion 权限、付费计划或真实 workspace 才能验证的能力，必须在测试和进度文档中标记。