Skip to main content
Glama

seafile-mcp (Seafile MCP connector)

MCP connector for a self-hosted Seafile server (seahub). It speaks the seahub HTTP API over stdio and over stateless Streamable HTTP on localhost.

Seafile server is GPLv2. This connector is MIT. It only calls the HTTP API on the server you configure. It is not affiliated with Seafile Ltd. Bring your own account token or library API token.

seafile.routes.json is a route table derived with ast from haiwen/seahub v14.0.9-server (seahub/urls.py and seahub/api2/urls.py). It is not an official OpenAPI document, and it has no request body schemas. The connector covers all 655 routes in that table (/api2/* and /api/v2.1/*). Routes are grouped into 24 toolsets. SEAFILE_TOOLSETS selects a subset. The default set is small and read-focused. all enables every toolset, including admin.

There is no default base URL. SEAFILE_URL is required. Hosts on seafile.com, including cloud.seafile.com, are refused.

Setup

npm install
npm run ci
npm start
npm run start:http

npm start speaks stdio. npm run start:http serves Streamable HTTP at http://127.0.0.1:3000/mcp and GET /health. HTTP mode has no authentication of its own. Keep it on localhost.

Create a token with POST /api2/auth-token/ on your server, or create a library API token in the Seafile UI. Put it in SEAFILE_TOKEN. The connector sends Authorization: Token and never prints the token. It does not store a username or password. A library API token cannot delete, move, or copy.

{
  "mcpServers": {
    "seafile": {
      "command": "node",
      "args": ["/workspace/connectors/seafile/dist/index.js"],
      "env": {
        "SEAFILE_URL": "http://127.0.0.1:8000",
        "SEAFILE_TOKEN": "...",
        "SEAFILE_ALLOW_WRITES": "false",
        "SEAFILE_TOOLSETS": "server,libraries,files_and_dirs,search",
        "SEAFILE_CONTACT": "you@example.com"
      }
    }
  }
}

If the file server is on another origin than SEAFILE_URL, set SEAFILE_FILE_SERVER_URL to that origin (often port 8082). read_text_file and write_text_file fetch only that origin, the SEAFILE_URL origin, or a /seafhttp path on the same host. They do not follow redirects to any other host.

Docker (HTTP, no authentication, localhost only):

docker build -t seafile-mcp .
docker run -p 3000:3000 \
  -e SEAFILE_URL=http://host.docker.internal:8000 \
  -e SEAFILE_TOKEN=... \
  seafile-mcp

Do not put the token in the image.

Regenerate the operations registry after a route-table bump:

npm run gen:operations

Related MCP server: Syncthing MCP

Config

Variable

Meaning

SEAFILE_URL

Required. Self-hosted seahub origin. No default. seafile.com hosts are refused.

SEAFILE_TOKEN

Account token or library API token. Sent as Authorization: Token.

SEAFILE_FILE_SERVER_URL

Optional file-server origin for upload and download URLs that are not on SEAFILE_URL. Hosted Seafile domains are refused.

SEAFILE_REVEAL_LINK_TOKENS

Optional, default off. Set to true to show share and upload link tokens and URLs, so a created link can be given out and deleted by token. Account token and passwords stay redacted either way.

SEAFILE_ALLOW_WRITES

Must be the literal true before a confirmed write is sent.

SEAFILE_TOOLSETS

Comma list of toolsets, or all. Default server,libraries,files_and_dirs,search.

SEAFILE_PER_MINUTE

Local request budget. Default 30.

SEAFILE_TIMEOUT_MS

Upstream timeout. Default 20000.

SEAFILE_CACHE_TTL_SEC

GET cache TTL. Default 60. Writes clear the cache.

SEAFILE_CONTACT

Contact token in the User-Agent.

MCP_TRANSPORT

stdio or http. --http overrides.

PORT

HTTP port. Default 3000.

Safety

Every non-GET route is a write. So is any GET that mints a download URL, upload URL, update URL, auth token, WebDAV secret, SSO link, or similar credential. A write needs confirm set to the boolean true and SEAFILE_ALLOW_WRITES=true. Otherwise the tool returns a dry-run preview of the method, path, query, and redacted body, and it sends nothing. The string "true" and the boolean false are rejected.

Delete, purge, expire, revert, trash clean, move, copy, and overwrite previews name the library id and the path. The same warning is in the tool description for destructive and credential actions.

read_text_file and write_text_file are extra actions on seafile_files_and_dirs. Both are gated. They stay inside one library path (absolute, no ..). Text only. 256 KiB cap. write_text_file replace defaults to false. replace: true adds an overwrite warning and names the target.

Responses are parsed as JSON objects, arrays (items), or strings (value). stack and traceback fields are dropped. Error text drops server stack traces and filesystem paths. Field names for tokens, passwords, pwd_hash, magic, and random_key are redacted. Share-link and file-server tokens in URLs are redacted. repo_id is kept.

HTTP 401 is unauthorized. HTTP 403 is forbidden. HTTP 404 is not found. HTTP 400 and 422 are invalid. HTTP 429 is rate limited and includes Retry-After. HTTP 5xx is a server error. Connection failures are network errors. Timeouts are timeouts.

/api2/ bodies are sent as form fields. /api/v2.1/ bodies are sent as JSON. Query object and body object are free-form because the route table has no schemas.

Tools

Default SEAFILE_TOOLSETS publishes 4 tools. SEAFILE_TOOLSETS=all publishes 24 tools (655 route operations, plus read_text_file and write_text_file on the files tool). Each tool takes action plus params, query, body, and confirm when the tool can write.

Toolset

Tool

Operations

Default

server

seafile_server

46

yes

libraries

seafile_libraries

39

yes

files_and_dirs

seafile_files_and_dirs

74

yes

search

seafile_search

6

yes

history_trash

seafile_history_trash

24

no

share_links

seafile_share_links

35

no

upload_links

seafile_upload_links

12

no

library_sharing

seafile_library_sharing

41

no

groups

seafile_groups

54

no

tags

seafile_tags

17

no

starred

seafile_starred

6

no

notifications

seafile_notifications

14

no

activities

seafile_activities

1

no

invitations

seafile_invitations

6

no

address_book

seafile_address_book

5

no

wikis

seafile_wikis

47

no

via_repo_token

seafile_via_repo_token

40

no

ocm

seafile_ocm

8

no

admin_users

seafile_admin_users

20

no

admin_libraries

seafile_admin_libraries

23

no

admin_groups

seafile_admin_groups

14

no

admin_logs

seafile_admin_logs

29

no

admin_shares

seafile_admin_shares

15

no

admin_system

seafile_admin_system

79

no

Example. List libraries, preview a create, then confirm it.

{ "action": "list_repos" }
{ "action": "create_repo", "body": { "name": "Lab" } }
{ "action": "create_repo", "body": { "name": "Lab" }, "confirm": true }

Read a text file after you set SEAFILE_ALLOW_WRITES=true.

{
  "action": "read_text_file",
  "params": { "repo_id": "REPO" },
  "query": { "p": "/notes/a.txt" },
  "confirm": true
}

Live check

npm run live-check and npm run live-check:extra talk to a real Seafile server when SEAFILE_URL and SEAFILE_TOKEN are set (SEAFILE_FILE_SERVER_URL too, if the fileserver is on another origin). They were run against a real local Seafile 9.0.10 server: failed=0, 59 checks. See LIVE-CHECK.md for exactly what was and was not exercised. They print pass and fail lines only and never the token.

This session did not run the live check. The parent runs it against a local server.

What this is not

This is not a Seafile desktop sync client. It does not watch folders or speak the sync protocol.

This is not a client for Seafile Cloud or any seafile.com host.

This is not an official OpenAPI SDK. Body fields come from seahub view code for the common routes and are free-form everywhere else.

This connector does not keep your password, and it does not turn a library API token into an account token. POST /api2/auth-token/ is a gated credential write. Its token is redacted in the result.

Admin toolsets are off unless you set SEAFILE_TOOLSETS.

Attribution

Seafile server is GPLv2. This connector is MIT and is not a derivative of the Seafile server. It is an independent HTTP client of the seahub API.

License

MIT, see LICENSE. This is an independent, unofficial connector and is not endorsed by the Seafile project or its owners.

seafile.routes.json is a route table derived from haiwen/seahub (Apache-2.0).

Available Tools

4 tools
seafile_files_and_dirsB
DestructiveIdempotent

seafile_files_and_dirs covers the files_and_dirs toolset (74 route operations). Auth header Authorization Token. Self-hosted Seafile only. seafile.com hosts are refused. Writes, including side-effect GETs, need confirm true and SEAFILE_ALLOW_WRITES=true. Omit confirm for a dry-run preview of method, path, and redacted body. Delete, purge, expire, revert, trash clean, move, copy, and overwrite previews name the library id and path. Actions: copy_repos_fileops: POST /api2/repos/{repo_id}/fileops/copy/. POST /api2/repos/{repo_id}/fileops/copy/ (OpCopyView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. create_related_files: POST /api/v2.1/related-files/. POST /api/v2.1/related-files/ (RelatedFilesView). Body and query are free-form. create_repos_file_comments: POST /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/. POST /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/ (FileCommentsView). Path params: repo_id, file_uuid. Body and query are free-form. create_repos_file_comments_replies: POST /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/. POST /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/ (FileCommentRepliesView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. create_repos_file_participants: POST /api/v2.1/repos/{repo_id}/file/participants/. POST /api/v2.1/repos/{repo_id}/file/participants/ (FileParticipantsView). Path params: repo_id. Body and query are free-form. delete_copy_move_task: DELETE /api/v2.1/copy-move-task/. DELETE /api/v2.1/copy-move-task/ (CopyMoveTaskView). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_dir: DELETE /api2/repos/{repo_id}/dir/. Delete a directory. Query p is the path. Destructive. Warning: destructive, exposure, or credential change. delete_file: DELETE /api2/repos/{repo_id}/file/. Delete a file into library trash. Query p is the path. Destructive. Warning: destructive, exposure, or credential change. delete_related_files: DELETE /api/v2.1/related-files/{related_id}/. DELETE /api/v2.1/related-files/{related_id}/ (RelatedFileView). Path params: related_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_batch_delete_folders_item: DELETE /api/v2.1/repos/batch-delete-folders-item/. DELETE /api/v2.1/repos/batch-delete-folders-item/ (RepoFoldersItemBatchDelete). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_batch_delete_item: DELETE /api/v2.1/repos/batch-delete-item/. DELETE /api/v2.1/repos/batch-delete-item/ (ReposBatchDeleteItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_dir: DELETE /api/v2.1/repos/{repo_id}/dir/. DELETE /api/v2.1/repos/{repo_id}/dir/ (DirView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_file: DELETE /api/v2.1/repos/{repo_id}/file/. DELETE /api/v2.1/repos/{repo_id}/file/ (FileView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_file_comments: DELETE /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/. DELETE /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/ (FileCommentView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_file_comments_replies: DELETE /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/. DELETE /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/ (FileCommentReplyView). Path params: repo_id, file_uuid, comment_id, reply_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_file_participant: DELETE /api/v2.1/repos/{repo_id}/file/participant/. DELETE /api/v2.1/repos/{repo_id}/file/participant/ (FileParticipantView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_file_detail: GET /api2/repos/{repo_id}/file/detail/. Read file detail for query p. get_file_download_link: GET /api2/repos/{repo_id}/file/. Mint a file download URL. Query p is the file path. Side-effect GET. The URL token is redacted. Warning: destructive, exposure, or credential change. get_repos_dir: GET /api/v2.1/repos/{repo_id}/dir/. GET /api/v2.1/repos/{repo_id}/dir/ (DirView). Path params: repo_id. Body and query are free-form. get_repos_dir_detail: GET /api/v2.1/repos/{repo_id}/dir/detail/. GET /api/v2.1/repos/{repo_id}/dir/detail/ (DirDetailView). Path params: repo_id. Body and query are free-form. get_repos_dir_metadata: GET /api2/repos/{repo_id}/dir/metadata/. GET /api2/repos/{repo_id}/dir/metadata/ (DirMetaDataView). Path params: repo_id. Body and query are free-form. get_repos_file: GET /api/v2.1/repos/{repo_id}/file/. GET /api/v2.1/repos/{repo_id}/file/ (FileView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_repos_file_comments: GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/. GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/ (FileCommentView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. get_repos_file_comments_replies: GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/. GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/ (FileCommentReplyView). Path params: repo_id, file_uuid, comment_id, reply_id. Body and query are free-form. get_repos_file_metadata: GET /api2/repos/{repo_id}/file/metadata/. GET /api2/repos/{repo_id}/file/metadata/ (FileMetaDataView). Path params: repo_id. Body and query are free-form. get_repos_files_blks_download_link: GET /api2/repos/{repo_id}/files/{file_id}/blks/{block_id}/download-link/. GET /api2/repos/{repo_id}/files/{file_id}/blks/{block_id}/download-link/ (FileBlockDownloadLinkView). Path params: repo_id, file_id, block_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_repos_office_suite: GET /api/v2.1/repos/{repo_id}/office-suite/. GET /api/v2.1/repos/{repo_id}/office-suite/ (OfficeSuiteConfig). Path params: repo_id. Body and query are free-form. get_repos_owa_file: GET /api2/repos/{repo_id}/owa-file/. GET /api2/repos/{repo_id}/owa-file/ (OwaFileView). Path params: repo_id. Body and query are free-form. get_repos_thumbnail: GET /api2/repos/{repo_id}/thumbnail/. GET /api2/repos/{repo_id}/thumbnail/ (ThumbnailView). Path params: repo_id. Body and query are free-form. get_repos_update_blks_link: GET /api2/repos/{repo_id}/update-blks-link/. GET /api2/repos/{repo_id}/update-blks-link/ (UpdateBlksLinkView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_repos_upload_blks_link: GET /api2/repos/{repo_id}/upload-blks-link/. GET /api2/repos/{repo_id}/upload-blks-link/ (UploadBlksLinkView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_repos_zip_task: GET /api/v2.1/repos/{repo_id}/zip-task/. GET /api/v2.1/repos/{repo_id}/zip-task/ (ZipTaskView). Path params: repo_id. Body and query are free-form. get_share_link_zip_task: GET /api/v2.1/share-link-zip-task/. GET /api/v2.1/share-link-zip-task/ (ShareLinkZipTaskView). Body and query are free-form. get_update_link: GET /api2/repos/{repo_id}/update-link/. Mint a file-server update URL for an existing file. Side-effect GET. Warning: destructive, exposure, or credential change. get_upload_link: GET /api2/repos/{repo_id}/upload-link/. Mint a file-server upload URL for query p. Side-effect GET. replace=1 allows overwrite. Warning: destructive, exposure, or credential change. list_dir: GET /api2/repos/{repo_id}/dir/. List a directory. Query p is the directory path. p defaults to / on the server. list_query_copy_move_progress: GET /api/v2.1/query-copy-move-progress/. GET /api/v2.1/query-copy-move-progress/ (QueryCopyMoveProgressView). Body and query are free-form. list_query_zip_progress: GET /api/v2.1/query-zip-progress/. GET /api/v2.1/query-zip-progress/ (QueryZipProgressView). Body and query are free-form. list_recent_added_files: GET /api/v2.1/recent-added-files/. GET /api/v2.1/recent-added-files/ (RecentAddedFilesView). Body and query are free-form. list_related_files: GET /api/v2.1/related-files/. GET /api/v2.1/related-files/ (RelatedFilesView). Body and query are free-form. list_repos_file_comments: GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/. GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/ (FileCommentsView). Path params: repo_id, file_uuid. Body and query are free-form. list_repos_file_comments_replies: GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/. GET /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/ (FileCommentRepliesView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. list_repos_file_participants: GET /api/v2.1/repos/{repo_id}/file/participants/. GET /api/v2.1/repos/{repo_id}/file/participants/ (FileParticipantsView). Path params: repo_id. Body and query are free-form. list_repos_file_uploaded_bytes: GET /api/v2.1/repos/{repo_id}/file-uploaded-bytes/. GET /api/v2.1/repos/{repo_id}/file-uploaded-bytes/ (RepoFileUploadedBytesView). Path params: repo_id. Body and query are free-form. list_repos_related_users: GET /api/v2.1/repos/{repo_id}/related-users/. GET /api/v2.1/repos/{repo_id}/related-users/ (RepoRelatedUsersView). Path params: repo_id. Body and query are free-form. move_repos_fileops: POST /api2/repos/{repo_id}/fileops/move/. POST /api2/repos/{repo_id}/fileops/move/ (OpMoveView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_async_batch_move_item_callback: POST /api/v2.1/async-batch-move-item/callback/. POST /api/v2.1/async-batch-move-item/callback/ (BatchMoveItemsUpdatePath). Body and query are free-form. Warning: destructive, exposure, or credential change. post_cancel_zip_task: POST /api/v2.1/cancel-zip-task/. POST /api/v2.1/cancel-zip-task/ (CancelZipTaskView). Body and query are free-form. post_copy_move_task: POST /api/v2.1/copy-move-task/. POST /api/v2.1/copy-move-task/ (CopyMoveTaskView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_dir: POST /api2/repos/{repo_id}/dir/. Create, rename, or move a directory. Query p is the path. Form operation is mkdir, rename, or move. post_file: POST /api2/repos/{repo_id}/file/. Create, rename, move, or copy a file. Query p is the path. Form operation is create, rename, move, or copy. Warning: destructive, exposure, or credential change. post_move_folder_merge: POST /api/v2.1/move-folder-merge/. POST /api/v2.1/move-folder-merge/ (MoveFolderMergeView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_async_batch_copy_item: POST /api/v2.1/repos/async-batch-copy-item/. POST /api/v2.1/repos/async-batch-copy-item/ (ReposAsyncBatchCopyItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_async_batch_move_item: POST /api/v2.1/repos/async-batch-move-item/. POST /api/v2.1/repos/async-batch-move-item/ (ReposAsyncBatchMoveItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_batch_copy_dir: POST /api/v2.1/repos/batch-copy-dir/. POST /api/v2.1/repos/batch-copy-dir/ (ReposBatchCopyDirView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_batch_copy_item: POST /api/v2.1/repos/batch-copy-item/. POST /api/v2.1/repos/batch-copy-item/ (ReposBatchCopyItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_batch_create_dir: POST /api/v2.1/repos/batch-create-dir/. POST /api/v2.1/repos/batch-create-dir/ (ReposBatchCreateDirView). Body and query are free-form. post_repos_batch_move_item: POST /api/v2.1/repos/batch-move-item/. POST /api/v2.1/repos/batch-move-item/ (ReposBatchMoveItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_dir: POST /api/v2.1/repos/{repo_id}/dir/. POST /api/v2.1/repos/{repo_id}/dir/ (DirView). Path params: repo_id. Body and query are free-form. post_repos_file: POST /api/v2.1/repos/{repo_id}/file/. POST /api/v2.1/repos/{repo_id}/file/ (FileView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_fileops_delete: POST /api2/repos/{repo_id}/fileops/delete/. POST /api2/repos/{repo_id}/fileops/delete/ (OpDeleteView). Path params: repo_id. Body and query are free-form. post_repos_image_rotate: POST /api/v2.1/repos/{repo_id}/image-rotate/. POST /api/v2.1/repos/{repo_id}/image-rotate/ (RepoImageRotateView). Path params: repo_id. Body and query are free-form. post_repos_sync_batch_copy_item: POST /api/v2.1/repos/sync-batch-copy-item/. POST /api/v2.1/repos/sync-batch-copy-item/ (ReposSyncBatchCopyItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_sync_batch_move_item: POST /api/v2.1/repos/sync-batch-move-item/. POST /api/v2.1/repos/sync-batch-move-item/ (ReposSyncBatchMoveItemView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_upload_blks_link: POST /api2/repos/{repo_id}/upload-blks-link/. POST /api2/repos/{repo_id}/upload-blks-link/ (UploadBlksLinkView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_zip_task: POST /api/v2.1/repos/{repo_id}/zip-task/. POST /api/v2.1/repos/{repo_id}/zip-task/ (ZipTaskView). Path params: repo_id. Body and query are free-form. post_share_link_zip_task: POST /api/v2.1/share-link-zip-task/. POST /api/v2.1/share-link-zip-task/ (ShareLinkZipTaskView). Body and query are free-form. Warning: destructive, exposure, or credential change. put_file: PUT /api2/repos/{repo_id}/file/. Lock or unlock a file. Body operation is lock or unlock. Body p is the path. Warning: destructive, exposure, or credential change. update_repos_batch_lock_file: PUT /api/v2.1/repos/{repo_id}/batch-lock-file/. PUT /api/v2.1/repos/{repo_id}/batch-lock-file/ (FileBatchLockView). Path params: repo_id. Body and query are free-form. update_repos_batch_unlock_file: PUT /api/v2.1/repos/{repo_id}/batch-unlock-file/. PUT /api/v2.1/repos/{repo_id}/batch-unlock-file/ (FileBatchUnlockView). Path params: repo_id. Body and query are free-form. update_repos_file: PUT /api/v2.1/repos/{repo_id}/file/. PUT /api/v2.1/repos/{repo_id}/file/ (FileView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. update_repos_file_comments: PUT /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/. PUT /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/ (FileCommentView). Path params: repo_id, file_uuid, comment_id. Body and query are free-form. update_repos_file_comments_replies: PUT /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/. PUT /api/v2.1/repos/{repo_id}/file/{file_uuid}/comments/{comment_id}/replies/{reply_id}/ (FileCommentReplyView). Path params: repo_id, file_uuid, comment_id, reply_id. Body and query are free-form. update_repos_office_suite: PUT /api/v2.1/repos/{repo_id}/office-suite/. PUT /api/v2.1/repos/{repo_id}/office-suite/ (OfficeSuiteConfig). Path params: repo_id. Body and query are free-form. read_text_file: GET download link then fetch text. Query p is the library path. Params repo_id. Size cap 256 KiB. Text only. Gated. Warning: mints a download token. write_text_file: GET upload link then multipart POST. Query p is the library path. Body text string. Body replace defaults to false. Size cap 256 KiB. Gated. Warning: names the library id and path. replace true overwrites.

Inputs: action (required), body, query, params, +1 more.

seafile_librariesA
DestructiveIdempotent

seafile_libraries covers the libraries toolset (39 route operations). Auth header Authorization Token. Self-hosted Seafile only. seafile.com hosts are refused. Writes, including side-effect GETs, need confirm true and SEAFILE_ALLOW_WRITES=true. Omit confirm for a dry-run preview of method, path, and redacted body. Delete, purge, expire, revert, trash clean, move, copy, and overwrite previews name the library id and path. Actions: create_monitored_repos: POST /api/v2.1/monitored-repos/. POST /api/v2.1/monitored-repos/ (MonitoredRepos). Body and query are free-form. create_repo: POST /api2/repos/. Create a library. Form body field name is required. Encrypted libraries need passwd. The sync token in the response is redacted. create_repos_repo_api_tokens: POST /api/v2.1/repos/{repo_id}/repo-api-tokens/. Create a library API token. Credential-minting. Library tokens cannot delete, move, or copy. Warning: destructive, exposure, or credential change. create_repos_webhooks: POST /api/v2.1/repos/{repo_id}/webhooks/. POST /api/v2.1/repos/{repo_id}/webhooks/ (WebhooksView). Path params: repo_id. Body and query are free-form. delete_monitored_repos: DELETE /api/v2.1/monitored-repos/{repo_id}/. DELETE /api/v2.1/monitored-repos/{repo_id}/ (MonitoredRepo). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repo: DELETE /api2/repos/{repo_id}/. Delete a library. Destructive. The preview names repo_id. Warning: destructive, exposure, or credential change. delete_repos: DELETE /api/v2.1/repos/{repo_id}/. DELETE /api/v2.1/repos/{repo_id}/ (RepoView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_repo_api_tokens: DELETE /api/v2.1/repos/{repo_id}/repo-api-tokens/{app_name}/. DELETE /api/v2.1/repos/{repo_id}/repo-api-tokens/{app_name}/ (RepoAPITokenView). Path params: repo_id, app_name. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_webhooks: DELETE /api/v2.1/repos/{repo_id}/webhooks/. DELETE /api/v2.1/repos/{repo_id}/webhooks/ (WebhooksView). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_repos_webhooks_repo_id_webhook_id: DELETE /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/. DELETE /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/ (WebhooksView). Path params: repo_id, webhook_id. Body and query are free-form. Warning: destructive, exposure, or credential change. get_default_repo: GET /api2/default-repo/. GET /api2/default-repo/ (DefaultRepoView). Body and query are free-form. get_repo: GET /api2/repos/{repo_id}/. Read one library. get_repos: GET /api/v2.1/repos/{repo_id}/. GET /api/v2.1/repos/{repo_id}/ (RepoView). Path params: repo_id. Body and query are free-form. get_repos_auto_delete: GET /api/v2.1/repos/{repo_id}/auto-delete/. GET /api/v2.1/repos/{repo_id}/auto-delete/ (RepoAutoDeleteView). Path params: repo_id. Body and query are free-form. get_repos_download_info: GET /api2/repos/{repo_id}/download-info/. GET /api2/repos/{repo_id}/download-info/ (DownloadRepo). Path params: repo_id. Body and query are free-form. get_repos_history_limit: GET /api2/repos/{repo_id}/history-limit/. GET /api2/repos/{repo_id}/history-limit/ (RepoHistoryLimit). Path params: repo_id. Body and query are free-form. get_repos_owner: GET /api2/repos/{repo_id}/owner/. GET /api2/repos/{repo_id}/owner/ (RepoOwner). Path params: repo_id. Body and query are free-form. get_repos_public: GET /api2/repos/public/. GET /api2/repos/public/ (PubRepos). Body and query are free-form. get_repos_webhooks: GET /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/. GET /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/ (WebhooksView). Path params: repo_id, webhook_id. Body and query are free-form. list_repo_tokens: GET /api2/repo-tokens/. GET /api2/repo-tokens/ (RepoTokensView). Body and query are free-form. Warning: destructive, exposure, or credential change. list_repos: GET /api2/repos/. List libraries visible to the token. list_repos_get: GET /api/v2.1/repos/. GET /api/v2.1/repos/ (ReposView). Body and query are free-form. list_repos_repo_api_tokens: GET /api/v2.1/repos/{repo_id}/repo-api-tokens/. List library API tokens. Token values are redacted. list_repos_webhooks: GET /api/v2.1/repos/{repo_id}/webhooks/. GET /api/v2.1/repos/{repo_id}/webhooks/ (WebhooksView). Path params: repo_id. Body and query are free-form. post_default_repo: POST /api2/default-repo/. POST /api2/default-repo/ (DefaultRepoView). Body and query are free-form. post_repo: POST /api2/repos/{repo_id}/. Library password or rename. Query op is rename, setpassword, or checkpassword. Form fields repo_name and repo_desc for rename. post_repos_archive: POST /api/v2.1/repos/{repo_id}/archive/. POST /api/v2.1/repos/{repo_id}/archive/ (RepoArchiveView). Path params: repo_id. Body and query are free-form. post_repos_batch: POST /api/v2.1/repos/batch/. POST /api/v2.1/repos/batch/ (ReposBatchView). Body and query are free-form. post_repos_public: POST /api2/repos/public/. POST /api2/repos/public/ (PubRepos). Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_send_new_password: POST /api/v2.1/repos/{repo_id}/send-new-password/. POST /api/v2.1/repos/{repo_id}/send-new-password/ (RepoSendNewPassword). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_set_password: POST /api/v2.1/repos/{repo_id}/set-password/. POST /api/v2.1/repos/{repo_id}/set-password/ (RepoSetPassword). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. post_repos_webhooks: POST /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/. POST /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/ (WebhooksView). Path params: repo_id, webhook_id. Body and query are free-form. update_repos_auto_delete: PUT /api/v2.1/repos/{repo_id}/auto-delete/. PUT /api/v2.1/repos/{repo_id}/auto-delete/ (RepoAutoDeleteView). Path params: repo_id. Body and query are free-form. update_repos_history_limit: PUT /api2/repos/{repo_id}/history-limit/. PUT /api2/repos/{repo_id}/history-limit/ (RepoHistoryLimit). Path params: repo_id. Body and query are free-form. update_repos_owner: PUT /api2/repos/{repo_id}/owner/. PUT /api2/repos/{repo_id}/owner/ (RepoOwner). Path params: repo_id. Body and query are free-form. update_repos_repo_api_tokens: PUT /api/v2.1/repos/{repo_id}/repo-api-tokens/{app_name}/. PUT /api/v2.1/repos/{repo_id}/repo-api-tokens/{app_name}/ (RepoAPITokenView). Path params: repo_id, app_name. Body and query are free-form. Warning: destructive, exposure, or credential change. update_repos_set_password: PUT /api/v2.1/repos/{repo_id}/set-password/. PUT /api/v2.1/repos/{repo_id}/set-password/ (RepoSetPassword). Path params: repo_id. Body and query are free-form. Warning: destructive, exposure, or credential change. update_repos_webhooks: PUT /api/v2.1/repos/{repo_id}/webhooks/. PUT /api/v2.1/repos/{repo_id}/webhooks/ (WebhooksView). Path params: repo_id. Body and query are free-form. update_repos_webhooks_repo_id_webhook_id: PUT /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/. PUT /api/v2.1/repos/{repo_id}/webhooks/{webhook_id}/ (WebhooksView). Path params: repo_id, webhook_id. Body and query are free-form.

Inputs: action (required), body, query, params, +1 more.

seafile_serverB
DestructiveIdempotent

seafile_server covers the server toolset (46 route operations). Auth header Authorization Token. Self-hosted Seafile only. seafile.com hosts are refused. Writes, including side-effect GETs, need confirm true and SEAFILE_ALLOW_WRITES=true. Omit confirm for a dry-run preview of method, path, and redacted body. Delete, purge, expire, revert, trash clean, move, copy, and overwrite previews name the library id and path. Actions: account_info: GET /api2/account/info/. Read the account behind SEAFILE_TOKEN. The connector does not store a password. auth_ping: GET /api2/auth/ping/. Ping with the account token. Confirms the token is accepted. create_abuse_reports: POST /api/v2.1/abuse-reports/. POST /api/v2.1/abuse-reports/ (AbuseReportsView). Body and query are free-form. create_auth_token: POST /api2/auth-token/. Mint an account token. Credential-minting write. Output token is redacted. Prefer setting SEAFILE_TOKEN outside this connector. Warning: destructive, exposure, or credential change. delete_accounts: DELETE /api2/accounts/{email}/. DELETE /api2/accounts/{email}/ (Account). Path params: email. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_auth_token_by_session: DELETE /api/v2.1/auth-token-by-session/. DELETE /api/v2.1/auth-token-by-session/ (AuthTokenBySession). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_devices: DELETE /api2/devices/. DELETE /api2/devices/ (DevicesView). Body and query are free-form. Warning: destructive, exposure, or credential change. delete_two_factor_auth: DELETE /api2/two-factor-auth/{email}/. DELETE /api2/two-factor-auth/{email}/ (TwoFactorAuthView). Path params: email. Body and query are free-form. Warning: destructive, exposure, or credential change. delete_user: DELETE /api/v2.1/user/. DELETE /api/v2.1/user/ (User). Body and query are free-form. Warning: destructive, exposure, or credential change. get_accounts: GET /api2/accounts/{email}/. GET /api2/accounts/{email}/ (Account). Path params: email. Body and query are free-form. get_auth_token_by_session: GET /api/v2.1/auth-token-by-session/. GET /api/v2.1/auth-token-by-session/ (AuthTokenBySession). Body and query are free-form. Warning: destructive, exposure, or credential change. get_avatars_user_resized: GET /api2/avatars/user/{user}/resized/{size}/. GET /api2/avatars/user/{user}/resized/{size}/ (UserAvatarView). Path params: user, size. Body and query are free-form. get_client_sso_link: GET /api2/client-sso-link/. GET /api2/client-sso-link/ (ClientSSOLink). Body and query are free-form. Warning: destructive, exposure, or credential change. get_client_sso_link_token: GET /api2/client-sso-link/{token}/. GET /api2/client-sso-link/{token}/ (ClientSSOLink). Path params: token. Body and query are free-form. Warning: destructive, exposure, or credential change. get_query_io_status: GET /api/v2.1/query-io-status/. GET /api/v2.1/query-io-status/ (SeahubIOStatus). Body and query are free-form. get_subscription: GET /api/v2.1/subscription/. GET /api/v2.1/subscription/ (SubscriptionView). Body and query are free-form. get_user: GET /api/v2.1/user/. GET /api/v2.1/user/ (User). Body and query are free-form. get_user_avatar: GET /api/v2.1/user-avatar/. GET /api/v2.1/user-avatar/ (UserAvatarView). Body and query are free-form. get_webdav_secret: GET /api/v2.1/webdav-secret/. Read the WebDAV secret. Side-effect style credential read. The secret is redacted. Warning: destructive, exposure, or credential change. list_accounts: GET /api2/accounts/. GET /api2/accounts/ (Accounts). Body and query are free-form. list_devices: GET /api2/devices/. GET /api2/devices/ (DevicesView). Body and query are free-form. list_subscription_logs: GET /api/v2.1/subscription/logs/. GET /api/v2.1/subscription/logs/ (SubscriptionLogsView). Body and query are free-form. list_subscription_plans: GET /api/v2.1/subscription/plans/. GET /api/v2.1/subscription/plans/ (SubscriptionPlansView). Body and query are free-form. list_unseen_messages: GET /api2/unseen_messages/. GET /api2/unseen_messages/ (UnseenMessagesCountView). Body and query are free-form. ping: GET /api2/ping/. Ping the Seafile server. No library access. post_accounts: POST /api2/accounts/{email}/. POST /api2/accounts/{email}/ (Account). Path params: email. Body and query are free-form. post_auth_token_by_session: POST /api/v2.1/auth-token-by-session/. POST /api/v2.1/auth-token-by-session/ (AuthTokenBySession). Body and query are free-form. Warning: destructive, exposure, or credential change. post_avatars_user_resized: POST /api2/avatars/user/{user}/resized/{size}/. POST /api2/avatars/user/{user}/resized/{size}/ (UserAvatarView). Path params: user, size. Body and query are free-form. post_client_login: POST /api2/client-login/. POST /api2/client-login/ (ClientLoginTokenView). Body and query are free-form. post_client_sso_link: POST /api2/client-sso-link/. POST /api2/client-sso-link/ (ClientSSOLink). Body and query are free-form. Warning: destructive, exposure, or credential change. post_client_sso_link_token: POST /api2/client-sso-link/{token}/. POST /api2/client-sso-link/{token}/ (ClientSSOLink). Path params: token. Body and query are free-form. Warning: destructive, exposure, or credential change. post_device_wiped: POST /api2/device-wiped/. POST /api2/device-wiped/ (RemoteWipeReportView). Body and query are free-form. Warning: destructive, exposure, or credential change. post_logout_device: POST /api2/logout-device/. POST /api2/logout-device/ (LogoutDeviceView). Body and query are free-form. post_markdown_lint: POST /api/v2.1/markdown-lint/. POST /api/v2.1/markdown-lint/ (MarkdownLintView). Body and query are free-form. post_organization: POST /api2/organization/. POST /api2/organization/ (OrganizationView). Body and query are free-form. post_regdevice: POST /api2/regdevice/. POST /api2/regdevice/ (RegDevice). Body and query are free-form. post_user_avatar: POST /api/v2.1/user-avatar/. POST /api/v2.1/user-avatar/ (UserAvatarView). Body and query are free-form. post_user_convert_to_team: POST /api/v2.1/user/convert-to-team/. POST /api/v2.1/user/convert-to-team/ (UserConvertToTeamView). Body and query are free-form. post_user_list: POST /api/v2.1/user-list/. POST /api/v2.1/user-list/ (UserListView). Body and query are free-form. post_user_reset_password: POST /api/v2.1/user/reset-password/. POST /api/v2.1/user/reset-password/ (ResetPasswordView). Body and query are free-form. Warning: destructive, exposure, or credential change. server_info: GET /api2/server-info/. Read server version and feature flags. update_account_info: PUT /api2/account/info/. PUT /api2/account/info/ (AccountInfo). Body and query are free-form. update_accounts: PUT /api2/accounts/{email}/. PUT /api2/accounts/{email}/ (Account). Path params: email. Body and query are free-form. update_two_factor_auth: PUT /api2/two-factor-auth/{email}/. PUT /api2/two-factor-auth/{email}/ (TwoFactorAuthView). Path params: email. Body and query are free-form. update_user: PUT /api/v2.1/user/. PUT /api/v2.1/user/ (User). Body and query are free-form. update_webdav_secret: PUT /api/v2.1/webdav-secret/. Rotate the WebDAV secret. Credential-minting. The secret is redacted. Warning: destructive, exposure, or credential change.

Inputs: action (required), body, query, params, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 4 tools

    Disambiguation3/5

    The four tools split the surface by domain (files/dirs, libraries, search, server), which gives an agent a rough first cut, but boundaries leak: directory and file operations appear in both seafile_files_and_dirs and seafile_libraries, and each tool is a flat bundle of dozens of raw route actions (delete_dir vs delete_repos_dir, get_repo vs get_repos, list_repos vs list_repos_get, post_repo vs update_repos_*) that are hard to tell apart without reading full path semantics. Within each tool the agent must select among 6–74 near-duplicate REST endpoints, so misselection risk is high even though the four top-level buckets are reasonably distinct.

    Naming Consistency4/5

    Tool names follow a clean, predictable seafile_<domain> pattern (seafile_files_and_dirs, seafile_libraries, seafile_search, seafile_server) in consistent snake_case. However, the internal action names exposed inside each tool swing between clean task verbs (list_dir, delete_file, search_file) and raw route-derived artifacts (copy_repos_fileops, delete_repos_batch_delete_folders_item, post_repos_sync_batch_copy_item), which undermines the usability of the naming for selection.

    Tool Count2/5

    Only four tools carry roughly 165 underlying operations (74 + 39 + 6 + 46), so the surface is massively over-compressed into mega-tools rather than scoped by user intent. The tool count is nominally small but functionally far too coarse, forcing agents to navigate huge enumerated action lists for routine operations.

    Completeness3/5

    Core areas — library CRUD, file/dir operations, comments, locking, batch copy/move, upload/download links, search, account and server admin — are covered, so basic workflows have no dead ends. But major Seafile domains are absent: sharing/permissions, groups, trash/recycle-bin restore, file revisions, activities/notifications, wikis, and sync, despite sharing-related zip-task endpoints being present.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      C
      quality
      D
      maintenance
      Schema-driven MCP server that exposes all Paperclip API operations as typed MCP tools over stdio or Streamable HTTP, supporting both authenticated and local_mode deployments.
      100
      -
    • A
      license
      D
      quality
      C
      maintenance
      Enables secure, configurable access to one or more Syncthing instances over MCP, with read-only defaults and opt-in write, destructive, and administrative operations. Supports stdio and authenticated Streamable HTTP transports, typed tools, bounded responses, and multi-instance configuration.
      40
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Connects MCP clients to a self-hosted photo library through its REST API, exposing assets, albums, people, search, and optional administrative toolsets with read-only defaults and confirm-gated writes. It supports stdio and localhost Streamable HTTP transports.
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to interact with a self-hosted comic/library server through its HTTP API, exposing libraries, series, books, collections, readlists, metadata, and administrative operations with read/write safety controls over stdio or Streamable HTTP.
      7
      MIT