IMA MCP：让笔记和知识库接入工具调用

笔记和知识库积累起来之后，问题往往不只是保存，而是怎样让其他工具在授权范围内找到、读取和更新它们。IMA MCP 为 IMA 的笔记与知识库提供一层自托管的 MCP 桥接。

桥接负责什么

公开仓库列出的能力包括搜索和浏览知识库、读取与写入笔记、导入网页，以及通过 IMA OpenAPI 调用笔记和知识库接口。文件可用 Base64 上传，单文件上限为 6 MiB。仓库特别注明：上传接口经过模式检查，但尚未用真实用户文件验证。因此，能够构造请求与完成真实数据验收是两件事。

同一条链路，两类凭据

服务运行在使用者自己的环境里，以 Streamable HTTP 提供 MCP 入口，默认绑定本机回环地址。IMA 凭据决定能操作哪些用户数据；另一个独立访问密钥保护 MCP 接口。公开版本没有 stdio 传输，远程访问需要使用者自行配置经过认证的 HTTPS 入口。

访问密钥位于接口路径中，所以访问日志不能随意记录完整 URL。这个细节很容易被忽略：即使传输加密，如果日志长期保存了带密钥的地址，凭据仍可能从另一个地方泄露。

来源与公开范围

项目在上游 ima-mcp-server 的基础上发布，保留 MIT 许可和上游署名。2026 年 11 月的公开提交是现有公开历史的起点，并不代表项目从那一天才开始被构思。具体接口与部署要求请核对 README。