Knowman Mcp

io.github.Essatt由 GitHub 账号 Essatt 发布v0.3.0更新于 Nov 11, 2026

KnowMan MCP server: search, ask, save and read your Knowledge Base from any MCP client.

已验证Streamable HTTP可网页运行网页搜索与抓取知识与记忆

概览

AI 生成的概览

把助手连接到 KnowMan 知识库,使其能够检索、阅读、保存并回忆已存条目与记忆。

可以做什么
  • 一次调用即可在整个库中检索排序后的段落与记忆,或提出问题并获得带引用的回答
  • 读取单个条目的内容与元数据,并列出最近保存的条目
  • 将网址保存到收件箱或知识库,可附加备注并标记为内部或外部来源
  • 列出已保存的记忆,如主张、决策和操作手册(只读)
  • 在不返回正文的情况下搜索已存条目,支持位置与范围筛选(仅本地包)
适用场景
当你把研究资料、文章和自己的文档存放在 KnowMan,并希望助手基于该库作答、引用条目或在工作中新增链接时适用。托管端点适合只接受远程 MCP 服务器的客户端。
运行要求
可使用远程端点,或通过 npx 运行本地 npm 包,后者需要 Node.js 22 或更高版本。需要 KnowMan 账户与凭据:本地包使用 KNOWMAN_API_KEY 中的 API 密钥,远程服务器使用 Authorization 的 Bearer 头;支持 MCP OAuth 的客户端可直接在浏览器中登录。CLI 也可通过 knowman login 保存凭据。
安装前请注意
API 密钥可访问你的知识库,请勿写入提交到仓库的配置,并可在 KnowMan 设置中删除对应条目以撤销。保存操作会向收件箱或知识库写入数据。OAuth 访问仅限读取与保存两种范围,令牌不能创建其他 API 密钥。请求按令牌和 IP 限流。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Knowman Mcp,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Essatt%2Fknowman-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "knowman": {
      "type": "http",
      "url": "https://api.knowman.io/mcp"
    }
  }
}

README

@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)

ToolPurpose
kb_researchRetrieve ranked passages and memories across the whole library in one call; the assistant writes the answer.
kb_get_itemRead content and metadata for one item.
kb_recentList recently saved items.
kb_saveSave a URL to Inbox or Knowledge Base.

Local stdio package

ToolPurpose
kb_get_itemRead content and metadata for one item.
kb_saveSave a URL to Inbox or Knowledge Base.
kb_recentList recently saved items.
kb_searchSearch saved items without bodies; results carry trust. Deprecated; use kb_research on the hosted server.
kb_askAsk a question over the Knowledge Base or one item; returns an answer with citations. Deprecated; use kb_research on the hosted server.
kb_memoriesList 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=<your-key> -- 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 <key>:

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 "Authorization: Bearer <your-key>".

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: <app name>. 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-search  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.  --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  Ask a question over the whole Knowledge Base (or a single item when itemId is given); returns an answer plus citations whose itemId resolves via 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.
kb-get-item  Retrieve readable content and metadata for one item from the KnowMan Inbox, Knowledge Base, or Archive.  --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 from the KnowMan Inbox or Knowledge Base. Every result carries `trust`; 'internal' is the user's own knowledge.  --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  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.  --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.

来源:README.md,提交 331e04d

工具

0
该服务器需要登录,因此 SourceWeft 无法在没有账号的情况下读取其工具,也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.3.0最新Nov 11, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分