MCP ツール
これは MCP tool documentation の入口です。Repository は src/nilo/mcp_server/ を実装し、MCP Python SDK FastMCP 経由で local tools を expose します。
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 - Supported transports:
stdio,streamable-http
Tool domain documents
config.mdauth.mdpages.mdblocks.mddatabases.mddata_sources.mdusers.mdcomments.mdviews.mdfile_uploads.mdsearch.mdcustom_emojis.mdraw_api.md
Tool inventory
Current server は 46 tools を expose します。
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
Common rules
- MCP tools は Core だけを呼びます。CLI を呼んではいけません。
- Tool errors は structured
{"ok": false, "error": ...}payload を返します。 - Tokens は default で redacted です。
- Delete、archive、trash 系 tools は
destructiveHintを持ち、confirm=trueを要求します。 - Real Notion permissions、paid plans、real workspace が必要な capability は tests と progress documentation に明記します。