MCP 服务器

knowledgeowl

io.usefulapi/knowledgeowl
知识与文档 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Reads and manages KnowledgeOwl knowledge-base articles, categories, revisions, snippets, glossary terms, readers, search data, and related content.

create_article
Create an article
MUTATES KnowledgeOwl data: creates a new article. KnowledgeOwl API: POST /article.json (JSON). Required by the API: project_id, name, status, url_hash, visibility, and current_version (a nested object `{ <lang>: { title, body, ... } }` — pass it via the `fields` passthrough). Returns the created article.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project_id', 'name'], 'properties': {'name': {'type': 'string', 'description': 'The article name/title (required).'}, 'fields': {'type': 'object', 'description': 'Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'status': {'type': 'string', 'description': 'Publishing status, e.g. "published", "draft", "review".'}, 'url_hash': {'type': 'string', 'description': 'The article URL slug (e.g. "getting-started").'}, 'project_id': {'type': 'string', 'description': 'The knowledge base (project) id this article belongs to (required).'}, 'visibility': {'type': 'string', 'description': 'Visibility, e.g. "public" or "private".'}}}
create_category
Create a category
MUTATES KnowledgeOwl data: creates a new category (a node in the article tree). KnowledgeOwl API: POST /category.json (JSON). Required by the API: type, project_id, url_hash, name, visibility, status. Pass extra documented fields via `fields`. Returns the created category.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project_id', 'name'], 'properties': {'name': {'type': 'string', 'description': 'The category name (required).'}, 'type': {'type': 'string', 'description': 'The category type (e.g. "blank", "topic", "custom-content").'}, 'fields': {'type': 'object', 'description': 'Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'status': {'type': 'string', 'description': 'Publishing status, e.g. "active".'}, 'url_hash': {'type': 'string', 'description': 'The category URL slug.'}, 'project_id': {'type': 'string', 'description': 'The knowledge base (project) id this category belongs to (required).'}, 'visibility': {'type': 'string', 'description': 'Visibility, e.g. "public" or "private".'}}}
create_glossary_term
Create a glossary term
MUTATES KnowledgeOwl data: creates a glossary term and definition. KnowledgeOwl API: POST /glossaryterm.json (JSON). Pass extra documented fields via `fields`. Returns the created glossary term.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project_id', 'term'], 'properties': {'term': {'type': 'string', 'description': 'The glossary term (required).'}, 'fields': {'type': 'object', 'description': 'Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'definition': {'type': 'string', 'description': "The term's definition."}, 'project_id': {'type': 'string', 'description': 'The knowledge base (project) id this glossary term belongs to (required).'}}}
create_snippet
Create a snippet
MUTATES KnowledgeOwl data: creates a reusable content snippet. KnowledgeOwl API: POST /snippet.json (JSON). Pass the snippet body/content and any other documented field via `fields` (e.g. snippet_text/body). Returns the created snippet.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project_id', 'name'], 'properties': {'name': {'type': 'string', 'description': 'The snippet name (required).'}, 'fields': {'type': 'object', 'description': 'Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'project_id': {'type': 'string', 'description': 'The knowledge base (project) id this snippet belongs to (required).'}}}
get_article
Get an article
Fetch a single article by id. KnowledgeOwl API: GET /article/{id}.json. Returns { valid, data:{...} }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The article id (a Mongo-style hex string).'}}}
get_category
Get a category
Fetch a single category by id. KnowledgeOwl API: GET /category/{id}.json.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The category id (a Mongo-style hex string).'}}}
get_reader
Get a reader
Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The reader id (a Mongo-style hex string).'}}}
knowledgeowl_request
Raw read request
Power-user escape hatch: GET any KnowledgeOwl API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Pass the FULL API path after the base, starting with a slash, INCLUDING any query string, e.g. "/article.json?_page=2" or "/category/abc123.json". Returns the parsed JSON.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['path'], 'properties': {'path': {'type': 'string', 'description': 'Full API path after the base, starting with "/", e.g. "/article.json?_page=2".'}}}
list_article_revisions
List article revisions
List article revision history (read-only audit trail). KnowledgeOwl API: GET /articlerevision.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_articles
List articles
List knowledge-base articles. KnowledgeOwl API: GET /article.json. Optionally filter by project_id (the knowledge base). Returns the list envelope { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'project_id': {'type': 'string', 'description': 'Filter to a single knowledge base (project) id.'}}}
list_article_versions
List article versions
List article versions. KnowledgeOwl API: GET /articleversion.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_authors
List authors
List authors/agents (the team members who write and manage content). KnowledgeOwl API: GET /agent.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_categories
List categories
List categories (the article tree/table of contents). KnowledgeOwl API: GET /category.json. Optionally filter by project_id. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}, 'project_id': {'type': 'string', 'description': 'Filter to a single knowledge base (project) id.'}}}
list_comments
List comments
List reader comments / feedback on articles. KnowledgeOwl API: GET /comment.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_files
List files
List files in the file library (images/attachments). KnowledgeOwl API: GET /file.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_glossary_terms
List glossary terms
List glossary terms and definitions. KnowledgeOwl API: GET /glossaryterm.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_readers
List readers
List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_snippets
List snippets
List reusable content snippets. KnowledgeOwl API: GET /snippet.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_suggestions
List search suggestions
List search suggestions / reader search analytics (what readers searched for). KnowledgeOwl API: GET /suggest.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_synonyms
List synonyms
List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_tags
List tags
List article tags. KnowledgeOwl API: GET /tag.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
list_webhooks
List webhooks
List configured webhooks. KnowledgeOwl API: GET /webhook.json. Returns { valid, page_stats, data:[...] }.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'_page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'KnowledgeOwl pagination page number, 1-based.'}, 'params': {'type': 'object', 'description': 'Additional documented query-string filters/operators to send verbatim (merged with the typed params above).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}}}}
update_article
Update an article
MUTATES KnowledgeOwl data: updates an existing article. KnowledgeOwl API: PUT /article/{id}.json (JSON — only included fields change). Use the `fields` passthrough for current_version (title/body) and any other documented field. The path id is never sent in the body.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The article id to update (path only; required).'}, 'name': {'type': 'string', 'description': 'New article name/title.'}, 'fields': {'type': 'object', 'description': 'Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'status': {'type': 'string', 'description': 'New publishing status.'}, 'url_hash': {'type': 'string', 'description': 'New URL slug.'}, 'visibility': {'type': 'string', 'description': 'New visibility.'}}}
update_category
Update a category
MUTATES KnowledgeOwl data: updates an existing category. KnowledgeOwl API: PUT /category/{id}.json (JSON — only included fields change). Use the `fields` passthrough for any other documented field. The path id is never sent in the body.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The category id to update (path only; required).'}, 'name': {'type': 'string', 'description': 'New category name.'}, 'fields': {'type': 'object', 'description': 'Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'status': {'type': 'string', 'description': 'New publishing status.'}, 'url_hash': {'type': 'string', 'description': 'New URL slug.'}, 'visibility': {'type': 'string', 'description': 'New visibility.'}}}
已添加
create_glossary_term
2026年9月21日 02:44
已添加
create_snippet
2026年9月21日 02:44
已添加
update_category
2026年9月21日 02:44
已添加
create_category
2026年9月21日 02:44
已添加
update_article
2026年9月21日 02:44
已添加
create_article
2026年9月21日 02:44
已添加
knowledgeowl_request
2026年9月21日 02:44
已添加
list_authors
2026年9月21日 02:44
已添加
list_webhooks
2026年9月21日 02:44
已添加
list_synonyms
2026年9月21日 02:44
已添加
list_suggestions
2026年9月21日 02:44
已添加
list_article_revisions
2026年9月21日 02:44
已添加
list_article_versions
2026年9月21日 02:44
已添加
list_files
2026年9月21日 02:44
已添加
get_reader
2026年9月21日 02:44
已添加
list_readers
2026年9月21日 02:44
已添加
list_comments
2026年9月21日 02:44
已添加
list_glossary_terms
2026年9月21日 02:44
已添加
list_snippets
2026年9月21日 02:44
已添加
list_tags
2026年9月21日 02:44
已添加
get_category
2026年9月21日 02:44
已添加
list_categories
2026年9月21日 02:44
已添加
get_article
2026年9月21日 02:44
已添加
list_articles
2026年9月21日 02:44