KnowMan

MCP文档知识

提供方 未标注

文档知识 HTTP · 远程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

通过任何 MCP 客户端,在 KnowMan 知识库中搜索、提问并获取引用,还可阅读和保存条目。

一句话选型结论

按资料字段整理

KnowMan 属于文档知识类 MCP 服务器,HTTP · 远程,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式HTTP · 远程 鉴权OAuth 授权 部署方式支持远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

记忆

安装与配置

HTTP · 远程 OAuth 授权
连远程 HTTPS 端点,通常为 Streamable HTTP
npx add-mcp 'https://api.knowman.io/mcp'

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
KnowMan当前 未标注 HTTP · 远程 支持远程部署 有 2026-11-20
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类文档知识本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-11-20上游最后核验时间

详细介绍

9.4 KB
来自项目仓库与上游目录的原文,未做删改

@knowman/mcp

A stdio MCP server that lets an MCP client search, ask, save and read items in a KnowMan account.

Tools

Hosted server (remote)

Tool Purpose
kb_research Retrieve ranked passages and memories across the whole library in one call; the assistant writes the answer.
kb_get_item Read content and metadata for one item.
kb_recent List recently saved items.
kb_save Save a URL to Inbox or Knowledge Base.

Local stdio package

Tool Purpose
kb_research Retrieve ranked passages and memories across the whole library in one call; the assistant writes the answer. Also served by the local package from 0.3.1.
kb_get_item Read content and metadata for one item.
kb_save Save a URL to Inbox or Knowledge Base.
kb_recent List recently saved items.
kb_search Search saved items without bodies; results carry trust. Deprecated; use kb_research on the hosted server.
kb_ask Ask a question over the whole library (Inbox and Knowledge Base) by default; an optional scope narrows it to either location. Deprecated; use kb_research on the hosted server.
kb_memories List saved memories such as claims, decisions and playbooks; read-only. Deprecated; use kb_research on the hosted server.

Install

npx -y @knowman/mcp runs the server on demand. npm install -g @knowman/mcp installs the knowman-mcp command.

Requires Node.js 22 or newer.

Get a key

Sign in at https://app.knowman.io, create an API key in settings, and set it as KNOWMAN_API_KEY. Never commit the key.

Configuration

Claude Desktop (claude_desktop_config.json):```json
{
"mcpServers": {
"knowman": {
"command": "npx",
"args": ["-y", "@knowman/mcp"],
"env": {
"KNOWMAN_API_KEY": "<your-key>"
}
}
}
}


Claude Code:```bash
claude mcp add knowman --env KNOWMAN_API_KEY=&lt;your-key&gt; -- npx -y @knowman/mcp

Cursor (~/.cursor/mcp.json, or .cursor/mcp.json in a project): use the same mcpServers JSON as the Claude Desktop example above.

Prefer signing in with the browser instead of pasting a key? Install the package globally (npm install -g @knowman/mcp) and run knowman login. The saved credential is shared with knowman-mcp, so the env block is not needed. Run knowman status to check it.

The package runs on your own machine over stdio. KnowMan also runs a hosted server at the endpoint in the next section, for clients that only accept remote MCP servers, such as claude.ai custom connectors.

Remote (hosted) server

Endpoint: https://api.knowman.io/mcp (Streamable HTTP, stateless, JSON responses, MCP protocol 2025-11-25). It exposes four tools: kb_research, kb_get_item, kb_recent and kb_save (see Tools above).

claude.ai. Open Settings, then Connectors, then Add custom connector, and enter https://api.knowman.io/mcp. Sign in with your KnowMan account when the browser opens.

Sign in with OAuth. The server implements OAuth 2.1 for MCP: protected resource metadata at /.well-known/oauth-protected-resource/mcp, authorization server metadata at /.well-known/oauth-authorization-server, dynamic client registration, authorization code with PKCE (S256), and rotating refresh tokens. A client that supports MCP OAuth connects from the endpoint URL alone: it opens a consent page at app.knowman.io, you sign in and approve, and the client receives a one-hour access token plus a refresh token. Access is limited to two scopes: knowman.read (search and read) and knowman.write (save links).

Or use an API key. Create a key in your KnowMan settings and send it as Authorization: Bearer:```json
{
"mcpServers": {
"knowman": {
"url": "https://api.knowman.io/mcp",
"headers": { "Authorization": "Bearer <your-key>" }
}
}
}


Claude Code: `claude mcp add --transport http knowman https://api.knowman.io/mcp --header &quot;Authorization: Bearer &quot;`.

**What has been verified.** The official MCP TypeScript SDK client completes the whole OAuth flow against the live server (registration, consent, token, tool calls, refresh). We have not yet tested ChatGPT connectors or Cursor ourselves; the endpoint follows the requirements those products document, and the redirect URIs they use are allowed. If one of them fails to connect, please open an issue with the product and the error you see.

**Disconnect an app.** Open the API keys list in your KnowMan settings and delete the entry named `OAuth: `. Deleting it revokes the connection and its refresh token. Changing your password also revokes every connected app.

**Limits.** An API key or an OAuth token cannot create other API keys. Requests are rate limited per token and per IP.

## CLI reference

KnowMan CLI

Usage:
knowman <command> [options]

Account:
login [--web-url <url>] [--api-url <url>] [--label <name>] [--no-browser] [--scopes agent|read]
Sign in through your browser; the credential is shared with knowman-mcp.
logout
Revoke the saved key on the server and remove it.
status
Show whether you are signed in (never prints the key).

Global flags:
--json
--format <json|text> json = one compact document; lists become {"results":[...]}
--api-url <url>
--api-key <key>
--help
--version

Commands (each also works without the kb- prefix, e.g. "save", "search"):
kb-research
Retrieve ranked evidence across the user's whole library and distilled memories. Default tool for factual, strategic and how-to questions. Returns source passages, not an answer.
--question <STRING>
--max_passages <NUMBER> [optional]

kb-search
Deprecated: use kb_research. Search saved items in the KnowMan Inbox, Knowledge Base, or Archive without returning content bodies; a location filter costs one extra lookup per hit. Every result carries trust: 'internal' is the user's OWN knowledge (their pages, documents and designated links) and outranks 'external' saved articles on anything about the user themselves. Returns snippets only; kb_get_item reads the full text.
--query <STRING>
Text to search for in KnowMan.
--limit <NUMBER> [optional]
Maximum number of search results to return.
--location <STRING> [optional] (one of: inbox|kb|archive)
Optional Inbox, Knowledge Base, or Archive location filter.
--scope <STRING> [optional] (one of: internal|external|all)
Which knowledge to search: 'internal' (the user's own pages, documents and designated links), 'external' (articles they saved), or 'all'. Defaults to all.

kb-ask
Deprecated: use kb_research. Ask a question over the whole KnowMan library by default (Inbox and Knowledge Base; pass scope to narrow to kb or inbox), or a single item when itemId is given; returns an answer plus citations whose itemId resolves via kb_get_item. Answers specific questions with citations; may abstain on broad questions: then use kb_memories, kb_search and kb_get_item.
--question <STRING>
Question to ask over the KnowMan Knowledge Base.
--item-id <STRING> [optional]
Optional item id restricting the question.
--project-id <STRING> [optional]
Optional project id restricting the question.
--scope <STRING> [optional] (one of: all|kb|inbox)
Which part of the library to search: all (default): the whole library, Inbox and Knowledge Base; kb: Knowledge Base only; inbox: Inbox only. Ignored when itemId is given.

kb-get-item
Read the full text of one saved item by id when research evidence needs more context.
--id <STRING>
KnowMan item id to retrieve.

kb-save
Save a URL to the KnowMan Inbox or directly to the Knowledge Base. Pass trust:'internal' when the link is the user's own knowledge (their company docs, their own writing) rather than an outside article.
--url <STRING>
URL to save into KnowMan.
--location <STRING> [optional] (one of: inbox|kb)
Save into the Inbox or directly into the Knowledge Base.
--note <STRING> [optional]
Optional note to attach to the saved item.
--trust <STRING> [optional] (one of: internal|external)
Mark the saved link as the user's own knowledge ('internal' — their company docs, their own posts) rather than an outside article ('external', the default).

kb-recent
List recently saved items. Use only when the user asks about recent saves.
--limit <NUMBER> [optional]
Maximum number of recent items to return.
--location <STRING> [optional] (one of: inbox|kb)
Optional Inbox or Knowledge Base location filter.
--scope <STRING> [optional] (one of: internal|external|all)
Which knowledge to list: 'internal', 'external', or 'all' (default).
--source-type <ARRAY> [optional]
Optional source type filter: manual, extension, rss, newsletter, inbox, or import. Array or comma-separated string. Use sourceType:['manual','extension'] to return only the user's own saves (manual and extension saves). Defaults to all types.

kb-memories
Deprecated: use kb_research. List saved memories (claims, decisions, playbooks) from the Knowledge Base; use kind 'playbook' to find step-by-step processes the user has taught KnowMan. Read-only. Best first stop for process, strategy and how-to questions (kind 'playbook').
--project <STRING> [optional]
Optional project id as a UUID; project name lookup is unavailable.
--kind <STRING> [optional] (one of: claim|decision|playbook)
Optional memory kind: claim, decision, or playbook.
--query <STRING> [optional]
Optional case-insensitive title and body substring filter.
--limit <NUMBER> [optional]
Maximum number of memories to return.
```

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
KnowMan 怎么安装?

在客户端按下面的安装命令接入:npx add-mcp 'https://api.knowman.io/mcp'。装完在客户端配置里引用同一个包或端点。

KnowMan 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

KnowMan 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

KnowMan 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

KnowMan 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

KnowMan 能提供哪些能力?

资料显示能力标签包括 记忆。具体工具清单以官方文档为准。

KnowMan 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

KnowMan 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-11-20。