{"_id":"@baklib/baklib-mcp-server","_rev":"19-2dbcfda9ba5cab9580214997cf2e3be9","name":"@baklib/baklib-mcp-server","dist-tags":{"latest":"0.6.1"},"versions":{"0.0.6":{"name":"@baklib/baklib-mcp-server","version":"0.0.6","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","_id":"@baklib/baklib-mcp-server@0.0.6","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"homepage":"https://github.com/baklib/baklib-mcp-server#readme","bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"bin":{"baklib-mcp-server":"index.js"},"dist":{"shasum":"606b9d6851c7ee36f4b57c93af6f5df7d50d7a1f","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.0.6.tgz","fileCount":3,"integrity":"sha512-z8KFvZh9wJHMnojFGtX9K3s70nyd+oA7jK/rMM9Chw92SWKJ+3UcQiPfUgQZ9YRa66Cfac+gtcrK0/Dc1dNR7w==","signatures":[{"sig":"MEUCIQCxfleWHweUU8ps9sutKmWbS1p1jnACjAO34gPQiw3pVgIgOzhLhvqa+Nnl5eowExmSLOJoRsXTkHDk/DCuvuaV8P4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31277},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"aaaa251747db0c23a0699f26ad7fb9d616b12209","scripts":{"start":"node index.js"},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^4.2.0","dotenv":"^16.3.1","form-data":"^4.0.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/baklib-mcp-server_0.0.6_1765801324526_0.30377117239701135","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@baklib/baklib-mcp-server","version":"0.1.0","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","_id":"@baklib/baklib-mcp-server@0.1.0","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"homepage":"https://github.com/baklib/baklib-mcp-server#readme","bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"bin":{"baklib-mcp-server":"index.js"},"dist":{"shasum":"016ec950788f3fcabad578e3f3654c19a6387617","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.1.0.tgz","fileCount":33,"integrity":"sha512-vcY38WN7QqTG21XZjuOgmZfzF7pV0VT0qwPRUJzYHCqP6dKqNPMKQSba610KtNKpAtJmaYNeUjYKBbPD7EWcQA==","signatures":[{"sig":"MEQCIAnm1tmuWhYr/ZCAQnf6QpcfHP7x195hO/YD5XPv9phIAiBkUIw9R2K4poJTbel+h0rksdSo/zVq1uCYZqBd8j48uQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56735},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"6dbab51b5cf1dbd6e6d919f60c1ff4646ac78739","scripts":{"start":"node index.js"},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^4.2.0","dotenv":"^16.3.1","form-data":"^4.0.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/baklib-mcp-server_0.1.0_1766332096009_0.3406778373862762","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@baklib/baklib-mcp-server","version":"0.2.0","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","_id":"@baklib/baklib-mcp-server@0.2.0","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"homepage":"https://github.com/baklib/baklib-mcp-server#readme","bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"bin":{"baklib-mcp-server":"index.js"},"dist":{"shasum":"4b7d62a68c030382c82eda473c89047b1bab6097","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.2.0.tgz","fileCount":34,"integrity":"sha512-E4kOPPRiKG6OZkrqxJHSwdv7Pw+5qBHIrEB6LMuW6NvRVS76aEEoeE2m1/TkK85CpMCEJ31c4vZniyuxO5/1tA==","signatures":[{"sig":"MEQCICIuOjoYrs462h+sSzQnDkh/ngwQJTnaUnov/DG0l+GUAiB0KkNAyuzTrmZsqiTt5zaNYNI9CqyH2g0XKbE1hJqRrQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58357},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"60c7f88be6e40bd3113335d37edc16aebaf671dd","scripts":{"start":"node index.js"},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git"},"_npmVersion":"10.9.2","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^4.2.0","form-data":"^4.0.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/baklib-mcp-server_0.2.0_1774945057761_0.10554845091078624","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@baklib/baklib-mcp-server","version":"0.3.0","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","_id":"@baklib/baklib-mcp-server@0.3.0","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"homepage":"https://github.com/baklib/baklib-mcp-server#readme","bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"bin":{"baklib-mcp-server":"index.js"},"dist":{"shasum":"79dbec279d9f40e53bc20414b44f143ac61d25fa","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.3.0.tgz","fileCount":34,"integrity":"sha512-4ETCS7M+74e3LiLcmawH43HDkS0l0WM33bMXQMXSzxWPHPpP6ZlXVuJPAAnj9CEX+xYFAHDGvk0fluR1zHMCJQ==","signatures":[{"sig":"MEUCIG3QJmmAZVRBAD+dwEb3YZdywOGYPI4rvLsN2zPpXh/4AiEAxq1rKd0MT81tEVYId8pbHfYyzMgdQyfMx93L6OMUCX0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59807},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"d8fdacfc37652c2b264f6d7a0dc7c81f28eb4b44","scripts":{"start":"node index.js"},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git"},"_npmVersion":"10.9.2","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^4.2.0","form-data":"^4.0.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/baklib-mcp-server_0.3.0_1775723806201_0.34898482496830696","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@baklib/baklib-mcp-server","version":"0.4.0","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","_id":"@baklib/baklib-mcp-server@0.4.0","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"homepage":"https://github.com/baklib/baklib-mcp-server#readme","bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"bin":{"baklib-mcp-server":"index.js"},"dist":{"shasum":"798171f5ed5e1766815a4f682e14d908f6bed5bf","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.4.0.tgz","fileCount":34,"integrity":"sha512-9D0XagS5EcG2SwRFE3/VRwiGnZFTvvuY0LXOgObl//OcpWciGsPxq+SnTi6+47vBR69DBEk3eIX6rElYw2HbfQ==","signatures":[{"sig":"MEUCIQDtqp5q7I71AptnI209f8ds8W4fQIGtyAz5KR9IGBrRIgIgMElpHmToqAafWdM5mZsvtWUb5JH50hJ7r762aJ5RzSY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63525},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"7ae1f6960748004cb7c1590a6403367518fc3adb","scripts":{"start":"node index.js"},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git"},"_npmVersion":"10.9.2","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^4.2.0","form-data":"^4.0.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/baklib-mcp-server_0.4.0_1775727675636_0.4288219913870057","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@baklib/baklib-mcp-server","version":"0.5.0","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","_id":"@baklib/baklib-mcp-server@0.5.0","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"homepage":"https://github.com/baklib/baklib-mcp-server#readme","bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"bin":{"baklib-mcp-server":"index.js"},"dist":{"shasum":"b616e268c8e004112ea9df5827745952e79450ff","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.5.0.tgz","fileCount":35,"integrity":"sha512-tXexGa82yPbvYxzS9d3kczZBvA8IlV6k8KlGrmQoHtnyACuDL/K0mXsGLIZY6mT3eLfPQq1JEZOTp+s0tqyD+Q==","signatures":[{"sig":"MEUCIBl5vnFLWm+yqA1TrlUj0kRv8GY92kUn+9maTaVYX/zoAiEA+z4ATPnef7lCvth2Vgaen7VkuygC6NiJ8mgMUa7vyFs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68747},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"258b3d27e79139099afaed1aff3b82399dd7579e","scripts":{"start":"node index.js"},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git"},"_npmVersion":"10.9.2","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^4.2.0","form-data":"^4.0.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/baklib-mcp-server_0.5.0_1776347410673_0.7502717679270678","host":"s3://npm-registry-packages-npm-production"}},"0.5.2":{"name":"@baklib/baklib-mcp-server","version":"0.5.2","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","_id":"@baklib/baklib-mcp-server@0.5.2","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"homepage":"https://github.com/baklib/baklib-mcp-server#readme","bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"bin":{"baklib-mcp-server":"index.js"},"dist":{"shasum":"63817c4298747045d8443c06958856049c723fb1","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.5.2.tgz","fileCount":490,"integrity":"sha512-+cAWWY9COWua7WwrTaQelzuOOl3mRLAbfC8ZhTh3eXLzdwk3YIfCUEHlZHWFTOmnltkQQONoKJkfsjjht6PCiQ==","signatures":[{"sig":"MEYCIQCcqytiDop3JDIGY30YfJtCfwLc19wefOnKoq+4CMhKvwIhALW5xF1Hzgactv4IKTDzkfFT7/TkXExtKIN7XpZ3RFWe","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2801787},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"394c98bcf53a9558c965de5feba2b392258f9695","scripts":{"start":"node index.js","postinstall":"node scripts/ensure-bin.mjs"},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git"},"_npmVersion":"10.9.2","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^4.2.0","form-data":"^4.0.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/baklib-mcp-server_0.5.2_1776350143112_0.7145103434334041","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@baklib/baklib-mcp-server","version":"0.6.0","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","_id":"@baklib/baklib-mcp-server@0.6.0","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"homepage":"https://github.com/baklib/baklib-mcp-server#readme","bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"bin":{"baklib-mcp-server":"index.js"},"dist":{"shasum":"2beb043c04dd768175c7df1a640df34ef0e5cfab","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.6.0.tgz","fileCount":47,"integrity":"sha512-sdYLSsuyUkBQXH5Co2a2ch0sRAc6wj813vYlTLEnjjIgBTC+mf5PufM1see3tijwganyCYPWGS/We6vyxekurw==","signatures":[{"sig":"MEUCIEXLU5ZFMNpeLQQno0SFfaS0Bd7P0yW+JcBPpcYEAkprAiEAlRUp1ilP6AvaLoE/q8riQlnGVt0JtIhK1d96+Xe33oM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":101781},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"394c98bcf53a9558c965de5feba2b392258f9695","scripts":{"test":"node --test lib/*.test.js","start":"node index.js","postinstall":"node scripts/ensure-bin.mjs"},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git"},"_npmVersion":"10.9.2","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","directories":{},"_nodeVersion":"23.10.0","dependencies":{"zod":"^4.2.0","form-data":"^4.0.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/baklib-mcp-server_0.6.0_1778671523560_0.020338233208831102","host":"s3://npm-registry-packages-npm-production"}},"0.6.1":{"name":"@baklib/baklib-mcp-server","version":"0.6.1","description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","main":"index.js","type":"module","bin":{"baklib-mcp-server":"index.js"},"scripts":{"start":"node index.js","test":"node --test lib/*.test.js","postinstall":"node scripts/ensure-bin.mjs"},"keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"author":{"name":"Baklib"},"license":"MIT","repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git"},"bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"homepage":"https://github.com/baklib/baklib-mcp-server#readme","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","form-data":"^4.0.0","zod":"^4.2.0"},"_id":"@baklib/baklib-mcp-server@0.6.1","gitHead":"9811e7ebab2ea5821c40a3f2e917ad5413c20b34","_nodeVersion":"23.10.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-6y76bjgHod7wPAwHIX/RcYEZhK/2K8z+8TJhN/6+ZKvMFXX6iG8o4UTBXZxPozkMzGB6z6sExwCcddT2hU7SzA==","shasum":"40b76ef1b4848de80bb523aea3c91bc82dc3da82","tarball":"https://registry.npmjs.org/@baklib/baklib-mcp-server/-/baklib-mcp-server-0.6.1.tgz","fileCount":47,"unpackedSize":101782,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDAHilssdBaFhZ8JsuVu6ZLoNRT0C9l3Fdc0SLU+HLYLwIhAPsM7nRD7MA5AzNFg6jhHy7wKJ4ocLZX6HiDeF2nqly7"}]},"_npmUser":{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"},"directories":{},"maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/baklib-mcp-server_0.6.1_1778684200919_0.22679299115961382"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-15T10:48:58.697Z","modified":"2026-05-13T14:56:41.193Z","0.0.1":"2025-12-15T10:48:58.968Z","0.0.2":"2025-12-15T10:53:35.382Z","0.0.3":"2025-12-15T11:28:49.919Z","0.0.4":"2025-12-15T11:34:17.192Z","0.0.5":"2025-12-15T12:19:53.554Z","0.0.6":"2025-12-15T12:22:04.654Z","0.1.0":"2025-12-21T15:48:16.159Z","0.2.0":"2026-03-31T08:17:37.951Z","0.3.0":"2026-04-09T08:36:46.364Z","0.4.0":"2026-04-09T09:41:15.769Z","0.5.0":"2026-04-16T13:50:10.827Z","0.5.2":"2026-04-16T14:35:43.288Z","0.6.0":"2026-05-13T11:25:23.731Z","0.6.1":"2026-05-13T14:56:41.077Z"},"bugs":{"url":"https://github.com/baklib/baklib-mcp-server/issues"},"author":{"name":"Baklib"},"license":"MIT","homepage":"https://github.com/baklib/baklib-mcp-server#readme","keywords":["mcp","model-context-protocol","baklib","dam","knowledge-base","file-upload","api-client"],"repository":{"url":"git+https://github.com/baklib/baklib-mcp-server.git"},"description":"Baklib MCP Server - Model Context Protocol server for Baklib API integration (DAM and Knowledge Base)","maintainers":[{"name":"xiaohui-zhangxh","email":"ping@xiaohui.dev"}],"readme":"# Baklib MCP Server\n\nBaklib MCP Server 是一个 Model Context Protocol (MCP) 服务器，让 AI 助手可以直接访问和操作 Baklib 的资源库、知识库、站点及相关只读接口。当前在 [`lib/tools/index.js`](lib/tools/index.js) 中注册 **36** 个 MCP 工具；完整清单与排除范围见 [API-STATUS.md](./API-STATUS.md)。\n\n## 📋 功能特性\n\n### 资源库（DAM）\n- 上传文件到资源库\n- 查看、更新、删除文件与浏览列表\n- 知识片段创建与更新（BKE Markdown）；正文中 DAM 图片统一写 `![说明](dam-id=<iid>)`（`<iid>` 为上传后的组内 id）\n- 实体临时 URL、网址链接创建与更新\n- 资源合集列表与合集限额查询\n\n### 知识库（KB）\n- 创建文章\n- 查看文章内容\n- 更新文章\n- 删除文章\n- 搜索和浏览文章列表\n- 查看知识库列表与详情（不提供知识库创建/更新/删除，亦不接入 `spaces/.../limits` 等 MCP，见 [API-STATUS.md](./API-STATUS.md)）\n\n## 🚀 快速开始\n\n### 1. 安装配置\n\n在 Cursor 的 `.cursor/mcp.json` 文件中添加以下配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"baklib-mcp-server\": {\n      \"type\": \"command\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@baklib/baklib-mcp-server\"\n      ]\n    }\n  }\n}\n```\n\n**配置说明（固定优先级读取：环境变量中的密钥/地址 > 工作区 `.config` > `~/.config/`）**：\n- `BAKLIB_MCP_TOKEN`（必需）：你的 Baklib API 密钥对，格式为 `access_key:secret_key`\n- `BAKLIB_MCP_API_BASE`（可选）：API 基础地址，默认为 `https://open.baklib.com/api/v1`\n  - 私有化部署用户可配置为 `https://your-domain.com/api/v1`\n- `BAKLIB_MCP_WORKSPACE`（可选）：工作区根目录的绝对路径。若设置，会优先从 `$BAKLIB_MCP_WORKSPACE/.config/` 读取上述两项（文件内为纯文本）。在支持变量展开的 MCP 配置里可写为 `\"BAKLIB_MCP_WORKSPACE\": \"${workspaceFolder}\"`，由编辑器在启动子进程前展开为真实路径。\n\n将配置写入以下位置（文件内容就是变量值本身，建议末尾保留换行）：\n- 若已设置 `BAKLIB_MCP_WORKSPACE`：`$BAKLIB_MCP_WORKSPACE/.config/BAKLIB_MCP_TOKEN`（及可选的 `BAKLIB_MCP_API_BASE`）\n- 否则：`~/.config/BAKLIB_MCP_TOKEN`\n- 可选：`~/.config/BAKLIB_MCP_API_BASE`\n\n**可选：通过 Cursor Skill 协助安装与使用**  \n若希望对话中的 AI 按固定指引使用 Baklib MCP 与 BKE Markdown 相关能力，可从 [Baklib AI Skills](https://github.com/baklib-tools/skills) 安装技能（存放约定与更多技能见该仓库说明）：\n\n```bash\nnpx skills add baklib-tools/skills --skill baklib-mcp --skill baklib-bke-markdown\n```\n\n也可手动将仓库内对应技能目录拷贝到你项目中的 Cursor 技能目录（常见为 `.cursor/skills/`）。具体以 [baklib-tools/skills](https://github.com/baklib-tools/skills) 文档为准。\n\n### 2. 获取 API Token\n\n1. 登录 Baklib 后台\n2. 进入 **个人中心** → **API 密钥对**\n3. 创建新的 API 密钥对\n4. 复制 `access_key:secret_key` 格式的 token，替换配置中的 `your-api-token-here`\n\n### 3. 重启 Cursor\n\n配置完成后，重启 Cursor 使配置生效。\n\n### 常见问题：`npx` 报 `sh: baklib-mcp-server: command not found`\n\n若 **工作区就是本仓库根目录**（或用终端在本仓库里跑 `npx -y @baklib/baklib-mcp-server`），npm 会按本地包解析，但根目录的 `npm install` 有时不会生成 `node_modules/.bin/baklib-mcp-server`，会导致上述错误。**先在本仓库执行一次 `npm install`**（会运行 `postinstall` 补全链接）。若仍失败，可在 MCP 里改用 `\"command\": \"node\"`、`\"args\": [\"${workspaceFolder}/index.js\"]`（路径以你本机为准），或从任意**非本仓库**目录执行 `npx`。\n\n## 💬 使用示例\n\n配置完成后，你可以直接通过自然语言与 AI 助手对话，使用 Baklib 的功能。以下是一些示例：\n\n### 资源库操作\n\n**上传文件**\n```\n请帮我把 /path/to/image.jpg 上传到 Baklib 资源库\n```\n\n```\n上传这个文件到资源库：/Users/me/document.pdf\n```\n\n**查看文件信息**\n```\n查看资源库中 ID 为 123456 的文件信息\n```\n\n**更新文件信息**\n```\n把资源库中 ID 为 123456 的文件名称改为\"产品介绍.pdf\"，描述改为\"2025年产品介绍文档\"\n```\n\n**搜索文件**\n```\n在资源库中搜索名称包含\"产品\"的文件\n```\n\n```\n列出资源库中所有图片类型的文件，每页显示 20 个\n```\n\n**删除文件**\n```\n删除资源库中 ID 为 123456 的文件\n```\n\n### 知识库操作\n\n**查看知识库列表**\n```\n列出我所有的知识库\n```\n\n```\n显示我的知识库列表，每页 10 个\n```\n\n**查看知识库详情**\n```\n查看 ID 为 405 的知识库详情\n```\n\n**创建文章**\n```\n在知识库 405 中创建一篇文章，标题是\"使用指南\"，内容是\"这是使用指南的内容...\"\n```\n\n```\n在知识库 405 中创建一篇标题为\"快速开始\"的文章，内容使用 Markdown 格式\n```\n\n**查看文章**\n```\n查看知识库 405 中 ID 为 212916 的文章内容\n```\n\n**更新文章**\n```\n更新知识库 405 中 ID 为 212916 的文章，把标题改为\"新标题\"，内容改为\"新内容...\"\n```\n\n**搜索文章**\n```\n在知识库 405 中搜索包含\"API\"的文章\n```\n\n```\n列出知识库 405 中所有文章，每页 10 个\n```\n\n**创建子文章**\n```\n在知识库 405 中，在 ID 为 212916 的文章下创建一篇子文章，标题是\"详细说明\"\n```\n\n**删除文章**\n```\n删除知识库 405 中 ID 为 212916 的文章\n```\n\n### 组合操作示例\n\n**上传图片并创建文章**\n```\n先上传 /path/to/image.jpg 到资源库，然后在知识库 405 中创建一篇文章，标题是\"产品介绍\"，内容中包含刚才上传的图片\n```\n\n**批量操作**\n```\n列出知识库 405 中的所有文章，然后更新每篇文章的标题，在前面加上\"[2025]\"\n```\n\n## ⚠️ 注意事项\n\n1. **Token 格式**：Token 格式为 `access_key:secret_key`，不需要 `Bearer` 前缀\n2. **知识库 ID**：知识库在 API 中称为 \"spaces\"，使用 `space_id` 参数\n3. **文件大小**：注意 Baklib API 的文件大小限制\n4. **权限**：确保你的 API Token 有相应的操作权限\n\n## 📚 相关链接\n\n- [Baklib API 文档](https://dev.baklib.cn/api)\n- [npm 包页面](https://www.npmjs.com/package/@baklib/baklib-mcp-server)\n- [GitHub 仓库](https://github.com/baklib/baklib-mcp-server)\n- [开发者文档](./DEVELOPER.md) - 如需参与开发或了解更多技术细节\n\n## 📝 更新日志\n\n### v0.6.0 (2026-05-13)\n\n- **DAM**：知识片段、网址链接、实体 URL、合集与限额等 MCP 工具；片段 `body` 默认 `body_format=markdown`\n- **站点**：新增 `site_update_tag`；DAM 图片 Markdown 在写入前自动规范化（BKE 兼容）\n- **KB**：文章创建/更新 attributes 使用 `body_format=markdown`\n\n详细变更请查看 [CHANGELOG.md](./CHANGELOG.md)\n\n### v0.5.2 (2026-04-16)\n\n- **依赖**：移除 `node-fetch`，使用 Node 18+ 内置 `fetch`，消除安装时的 `node-domexception` 弃用告警\n\n详细变更请查看 [CHANGELOG.md](./CHANGELOG.md)\n\n### v0.5.1 (2026-04-16)\n\n- **修复**：在本仓库根目录使用 `npx @baklib/baklib-mcp-server` 时可能报 `baklib-mcp-server: command not found`；`npm install` 后由 `postinstall` 补全 `node_modules/.bin` 链接\n\n详细变更请查看 [CHANGELOG.md](./CHANGELOG.md)\n\n### v0.5.0 (2026-04-16)\n\n- **BKE**：查询参数统一使用 `body_format=markdown`（`Api::BodyFormatParam`：读响应 + 站点页 `template_variables` 写入格式）\n- **KB**：文章正文在 JSON attributes 里用 `body_format=markdown`（与 query 同名）\n- **站点 / DAM**：说明与行为对齐 Markdown 读写语义；`dam_upload_entity` 返回含 `iid`\n- **调试**：`BAKLIB_MCP_TRACE` 可选请求追踪；API 客户端响应解析增强\n\n详细变更请查看 [CHANGELOG.md](./CHANGELOG.md)\n\n### v0.4.0 (2026-04-09)\n\n- **配置**：支持 `BAKLIB_MCP_WORKSPACE`，可从项目目录下 `.config/` 读取 token（例如在 MCP 中设置 `\"BAKLIB_MCP_WORKSPACE\": \"${workspaceFolder}\"`）\n- **调试**：`BAKLIB_MCP_DEBUG=1` 可输出配置解析过程（不含密钥）\n\n详细变更请查看 [CHANGELOG.md](./CHANGELOG.md)\n\n### v0.3.0 (2026-04-09)\n\n- **DAM**：`dam_get_entity` 支持 `include_signed_id`、`purpose` 查询参数，便于动态表单与富文本等场景获取 `signed_id`\n\n详细变更请查看 [CHANGELOG.md](./CHANGELOG.md)\n\n### v0.1.0 (2025-12-15)\n\n#### 🎉 重大更新\n- **新增 18 个 API 工具**，大幅扩展功能覆盖范围\n- **代码架构重构**，将工具函数模块化，提高代码可维护性\n\n#### ✨ 新增功能\n- **站点管理**：站点页面和标签的完整 CRUD 操作，站点信息查询\n- **用户和成员管理**：用户列表、当前用户信息、成员信息查询\n- **主题管理**：模板主题列表查询\n- **第三方集成**：集成列表和详情查询\n\n#### 🔧 改进\n- 代码架构优化，每个工具函数独立为单独文件\n- 统一工具导出机制，更好的代码组织结构\n\n详细变更请查看 [CHANGELOG.md](./CHANGELOG.md)\n\n### v0.0.6 (2025-12-15)\n- 初始版本发布\n- 支持资源库完整功能（上传、查询、更新、删除文件）\n- 支持知识库完整功能（创建、查询、更新、删除文章，获取知识库列表）\n- 支持分页和筛选\n- 自动 MIME 类型检测\n\n---\n\n**版本**：0.6.0  \n**最后更新**：2026-05-13\n","readmeFilename":"README.md"}