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 分