
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.
概覽
把助理連接到 KnowMan 知識庫,讓它能搜尋、閱讀、儲存並回想已存項目與記憶。
- 可以做什麼
- 一次呼叫即可在整個資料庫中取得排序後的段落與記憶,或提出問題並取得附引用的回答
- 讀取單一項目的內容與中繼資料,並列出最近儲存的項目
- 將網址儲存到收件匣或知識庫,可附加備註並標記為內部或外部來源
- 列出已儲存的記憶,例如主張、決策與操作手冊(唯讀)
- 在不回傳內文的情況下搜尋已存項目,支援位置與範圍篩選(僅本機套件)
- 適用情境
- 當你把研究資料、文章與自己的文件存放在 KnowMan,並希望助理依據該資料庫作答、引用項目或在工作過程中新增連結時適用。託管端點適合只接受遠端 MCP 伺服器的用戶端。
- 執行需求
- 可使用遠端端點,或以 npx 執行本機 npm 套件,後者需要 Node.js 22 或更新版本。需要 KnowMan 帳號與憑證:本機套件使用 KNOWMAN_API_KEY 中的 API 金鑰,遠端伺服器使用 Authorization 的 Bearer 標頭;支援 MCP OAuth 的用戶端可直接在瀏覽器登入。CLI 也可透過 knowman login 儲存憑證。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Knowman Mcp,將其新增到工作區。
- 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
- 為需要使用其工具的對話啟用該服務。
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)
Local stdio package
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):
Claude Code:
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>:
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
來源:README.md,提交 331e04d
工具
0版本歷史
1- v0.3.0最新Nov 11, 2026
評分
已滿足適用檢查項的 85%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
- 已宣告認證方式必需10 分
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分