
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 分