[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-alioshr--memory-bank-mcp":3,"tool-alioshr--memory-bank-mcp":64},[4,16,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":15},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,14],"Agent","插件","ready",{"id":17,"name":18,"github_repo":19,"description_zh":20,"stars":21,"difficulty_score":22,"last_commit_at":23,"category_tags":24,"status":15},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,2,"2026-04-10T01:20:03",[14,13,25,26],"图像","开发框架",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":22,"last_commit_at":33,"category_tags":34,"status":15},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[14,26],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":22,"last_commit_at":41,"category_tags":42,"status":15},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85267,"2026-04-18T11:00:28",[25,43,44,14,13,45,46,26,47],"数据工具","视频","其他","语言模型","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":22,"last_commit_at":54,"category_tags":55,"status":15},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",75502,"2026-04-18T11:08:56",[13,14],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":15},7525,"codex","openai\u002Fcodex","Codex 是 OpenAI 推出的一款轻量级编程智能体，专为在终端环境中高效运行而设计。它允许开发者直接在命令行界面与 AI 交互，完成代码生成、调试、重构及项目维护等任务，无需频繁切换至浏览器或集成开发环境，从而显著提升了编码流程的连贯性与专注度。\n\n这款工具主要解决了传统 AI 辅助编程中上下文割裂的问题。通过将智能体本地化运行，Codex 能够更紧密地结合当前工作目录的文件结构，提供更具针对性的代码建议，同时支持以自然语言指令驱动复杂的开发操作，让“对话即编码”成为现实。\n\nCodex 非常适合习惯使用命令行的软件工程师、全栈开发者以及技术研究人员。对于追求极致效率、偏好键盘操作胜过图形界面的极客用户而言，它更是理想的结对编程伙伴。\n\n其独特亮点在于灵活的部署方式：既可作为全局命令行工具通过 npm 或 Homebrew 一键安装，也能无缝对接现有的 ChatGPT 订阅计划（如 Plus 或 Pro），直接复用账户权益。此外，它还提供了从纯文本终端到桌面应用的多形态体验，并支持基于 API 密钥的深度定制，充分满足不同场景下的开发需求。",75220,"2026-04-14T14:40:34",[46,13,14],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":80,"owner_location":81,"owner_email":82,"owner_twitter":82,"owner_website":82,"owner_url":83,"languages":84,"stars":97,"forks":98,"last_commit_at":99,"license":100,"difficulty_score":22,"env_os":101,"env_gpu":102,"env_ram":103,"env_deps":104,"category_tags":109,"github_topics":110,"view_count":22,"oss_zip_url":82,"oss_zip_packed_at":82,"status":15,"created_at":120,"updated_at":121,"faqs":122,"releases":153},9241,"alioshr\u002Fmemory-bank-mcp","memory-bank-mcp","A Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.","memory-bank-mcp 是一款基于模型上下文协议（MCP）构建的远程记忆库管理服务，灵感源自 Cline Memory Bank 项目。它旨在解决传统基于文件的记忆库在多项目管理中面临的分散、结构不一致及访问受限等痛点。通过将本地文件转化为集中式服务，memory-bank-mcp 让 AI 助手能够安全、高效地跨项目读取和更新上下文信息，同时严格维持文件结构的规范性。\n\n这款工具特别适合正在使用 Cline、Roo Code、Cursor 或 Claude Desktop 等 AI 编程助手的开发者。对于需要维护复杂项目文档、长期任务状态或团队知识库的用户而言，它能显著提升 AI 对项目背景的理解能力与连续性。\n\n其核心技术亮点在于强大的多项目支持与安全隔离机制。memory-bank-mcp 不仅支持按项目划分目录和自动验证文件结构，还内置了防止路径遍历的安全策略，确保不同项目的记忆数据互不干扰。此外，它提供了类型安全的远程操作接口，涵盖读写更新、项目列举及文件查询等功能，并允许用户灵活配置自动审批策略，在保障安全的前提下优化交互体验。无论是个人开发者管理多个代码库，还是团","memory-bank-mcp 是一款基于模型上下文协议（MCP）构建的远程记忆库管理服务，灵感源自 Cline Memory Bank 项目。它旨在解决传统基于文件的记忆库在多项目管理中面临的分散、结构不一致及访问受限等痛点。通过将本地文件转化为集中式服务，memory-bank-mcp 让 AI 助手能够安全、高效地跨项目读取和更新上下文信息，同时严格维持文件结构的规范性。\n\n这款工具特别适合正在使用 Cline、Roo Code、Cursor 或 Claude Desktop 等 AI 编程助手的开发者。对于需要维护复杂项目文档、长期任务状态或团队知识库的用户而言，它能显著提升 AI 对项目背景的理解能力与连续性。\n\n其核心技术亮点在于强大的多项目支持与安全隔离机制。memory-bank-mcp 不仅支持按项目划分目录和自动验证文件结构，还内置了防止路径遍历的安全策略，确保不同项目的记忆数据互不干扰。此外，它提供了类型安全的远程操作接口，涵盖读写更新、项目列举及文件查询等功能，并允许用户灵活配置自动审批策略，在保障安全的前提下优化交互体验。无论是个人开发者管理多个代码库，还是团队协同构建知识系统，memory-bank-mcp 都能提供一个稳定可靠的底层记忆支撑。","# Memory Bank MCP Server\n\n[![smithery badge](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Falioshr_memory-bank-mcp_readme_2ab22774b7ca.png)](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@alioshr\u002Fmemory-bank-mcp)\n[![npm version](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F%40allpepper%2Fmemory-bank-mcp.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@allpepper\u002Fmemory-bank-mcp)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@allpepper\u002Fmemory-bank-mcp.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@allpepper\u002Fmemory-bank-mcp)\n\n\u003Ca href=\"https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002Fir18x1tixp\">\u003Cimg width=\"380\" height=\"200\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Falioshr_memory-bank-mcp_readme_f7ced79dcdb2.png\" alt=\"Memory Bank Server MCP server\" \u002F>\u003C\u002Fa>\n\nA Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by [Cline Memory Bank](https:\u002F\u002Fgithub.com\u002Fnickbaumann98\u002Fcline_docs\u002Fblob\u002Fmain\u002Fprompting\u002Fcustom%20instructions%20library\u002Fcline-memory-bank.md).\n\n## Overview\n\nThe Memory Bank MCP Server transforms traditional file-based memory banks into a centralized service that:\n\n- Provides remote access to memory bank files via MCP protocol\n- Enables multi-project memory bank management\n- Maintains consistent file structure and validation\n- Ensures proper isolation between project memory banks\n\n## Features\n\n- **Multi-Project Support**\n\n  - Project-specific directories\n  - File structure enforcement\n  - Path traversal prevention\n  - Project listing capabilities\n  - File listing per project\n\n- **Remote Accessibility**\n\n  - Full MCP protocol implementation\n  - Type-safe operations\n  - Proper error handling\n  - Security through project isolation\n\n- **Core Operations**\n  - Read\u002Fwrite\u002Fupdate memory bank files\n  - List available projects\n  - List files within projects\n  - Project existence validation\n  - Safe read-only operations\n\n## Installation\n\nTo install Memory Bank Server for Claude Desktop automatically via [Smithery](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@alioshr\u002Fmemory-bank-mcp):\n\n```bash\nnpx -y @smithery\u002Fcli install @alioshr\u002Fmemory-bank-mcp --client claude\n```\n\nThis will set up the MCP server configuration automatically. Alternatively, you can configure the server manually as described in the Configuration section below.\n\n## Quick Start\n\n1. Configure the MCP server in your settings (see Configuration section below)\n2. Start using the memory bank tools in your AI assistant\n\n## Using with Cline\u002FRoo Code\n\nThe memory bank MCP server needs to be configured in your Cline MCP settings file. The location depends on your setup:\n\n- For Cline extension: `~\u002FLibrary\u002FApplication Support\u002FCursor\u002FUser\u002FglobalStorage\u002Fsaoudrizwan.claude-dev\u002Fsettings\u002Fcline_mcp_settings.json`\n- For Roo Code VS Code extension: `~\u002FLibrary\u002FApplication Support\u002FCode\u002FUser\u002FglobalStorage\u002Frooveterinaryinc.roo-cline\u002Fsettings\u002Fmcp_settings.json`\n\nAdd the following configuration to your MCP settings:\n\n```json\n{\n  \"allpepper-memory-bank\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@allpepper\u002Fmemory-bank-mcp\"],\n    \"env\": {\n      \"MEMORY_BANK_ROOT\": \"\u003Cpath-to-bank>\"\n    },\n    \"disabled\": false,\n    \"autoApprove\": [\n      \"memory_bank_read\",\n      \"memory_bank_write\",\n      \"memory_bank_update\",\n      \"list_projects\",\n      \"list_project_files\"\n    ]\n  }\n}\n```\n\n### Configuration Details\n\n- `MEMORY_BANK_ROOT`: Directory where project memory banks will be stored (e.g., `\u002Fpath\u002Fto\u002Fmemory-bank`)\n- `disabled`: Set to `false` to enable the server\n- `autoApprove`: List of operations that don't require explicit user approval:\n  - `memory_bank_read`: Read memory bank files\n  - `memory_bank_write`: Create new memory bank files\n  - `memory_bank_update`: Update existing memory bank files\n  - `list_projects`: List available projects\n  - `list_project_files`: List files within a project\n\n## Using with Cursor\n\nFor Cursor, open the settings -> features -> add MCP server -> add the following:\n\n```shell\nenv MEMORY_BANK_ROOT=\u003Cpath-to-bank> npx -y @allpepper\u002Fmemory-bank-mcp@latest\n```\n## Using with Claude\n\n- Claude desktop config file: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n- Claude Code config file:  `~\u002F.claude.json`\n\n1. Locate the config file\n3. Locate the property called `mcpServers`\n4. Paste this:\n\n```\n \"allPepper-memory-bank\": {\n          \"type\": \"stdio\",\n          \"command\": \"npx\",\n          \"args\": [\n            \"-y\",\n            \"@allpepper\u002Fmemory-bank-mcp@latest\"\n          ],\n          \"env\": {\n            \"MEMORY_BANK_ROOT\": \"YOUR PATH\"\n          }\n        }\n```\n\n## Custom AI instructions\n\nThis section contains the instructions that should be pasted on the AI custom instructions, either for Cline, Claude or Cursor, or any other MCP client. You should copy and paste these rules. For reference, see [custom-instructions.md](custom-instructions.md) which contains these rules.\n\n## Development\n\nBasic development commands:\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run tests\nnpm run test\n\n# Run tests in watch mode\nnpm run test:watch\n\n# Run the server directly with ts-node for quick testing\nnpm run dev\n```\n\n### Running with Docker\n\n1. Build the Docker image:\n\n    ```bash\n    docker build -t memory-bank-mcp:local .\n    ```\n\n2. Run the Docker container for testing:\n\n    ```bash\n    docker run -i --rm \\\n      -e MEMORY_BANK_ROOT=\"\u002Fmnt\u002Fmemory_bank\" \\\n      -v \u002Fpath\u002Fto\u002Fmemory-bank:\u002Fmnt\u002Fmemory_bank \\\n      --entrypoint \u002Fbin\u002Fsh \\\n      memory-bank-mcp:local \\\n      -c \"ls -la \u002Fmnt\u002Fmemory_bank\"\n    ```\n\n3. Add MCP configuration, example for Roo Code:\n\n    ```json\n    \"allpepper-memory-bank\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \n        \"MEMORY_BANK_ROOT\",\n        \"-v\", \n        \"\u002Fpath\u002Fto\u002Fmemory-bank:\u002Fmnt\u002Fmemory_bank\",\n        \"memory-bank-mcp:local\"\n      ],\n      \"env\": {\n        \"MEMORY_BANK_ROOT\": \"\u002Fmnt\u002Fmemory_bank\"\n      },\n      \"disabled\": false,\n      \"alwaysAllow\": [\n        \"list_projects\",\n        \"list_project_files\",\n        \"memory_bank_read\",\n        \"memory_bank_update\",\n        \"memory_bank_write\"\n      ]\n    }\n    ```\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature\u002Famazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature\u002Famazing-feature`)\n5. Open a Pull Request\n\n### Development Guidelines\n\n- Use TypeScript for all new code\n- Maintain type safety across the codebase\n- Add tests for new features\n- Update documentation as needed\n- Follow existing code style and patterns\n\n### Testing\n\n- Write unit tests for new features\n- Include multi-project scenario tests\n- Test error cases thoroughly\n- Validate type constraints\n- Mock filesystem operations appropriately\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\nThis project implements the memory bank concept originally documented in the [Cline Memory Bank](https:\u002F\u002Fgithub.com\u002Fnickbaumann98\u002Fcline_docs\u002Fblob\u002Fmain\u002Fprompting\u002Fcustom%20instructions%20library\u002Fcline-memory-bank.md), extending it with remote capabilities and multi-project support.\n","# 内存库 MCP 服务器\n\n[![smithery 徽章](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Falioshr_memory-bank-mcp_readme_2ab22774b7ca.png)](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@alioshr\u002Fmemory-bank-mcp)\n[![npm 版本](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F%40allpepper%2Fmemory-bank-mcp.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@allpepper\u002Fmemory-bank-mcp)\n[![npm 下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@allpepper\u002Fmemory-bank-mcp.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@allpepper\u002Fmemory-bank-mcp)\n\n\u003Ca href=\"https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002Fir18x1tixp\">\u003Cimg width=\"380\" height=\"200\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Falioshr_memory-bank-mcp_readme_f7ced79dcdb2.png\" alt=\"Memory Bank Server MCP 服务器\" \u002F>\u003C\u002Fa>\n\n一个基于模型上下文协议（MCP）的远程内存库管理服务器实现，灵感来源于 [Cline Memory Bank](https:\u002F\u002Fgithub.com\u002Fnickbaumann98\u002Fcline_docs\u002Fblob\u002Fmain\u002Fprompting\u002Fcustom%20instructions%20library\u002Fcline-memory-bank.md)。\n\n## 概述\n\nMemory Bank MCP 服务器将传统的基于文件的内存库转换为集中式服务，具备以下功能：\n\n- 通过 MCP 协议提供对内存库文件的远程访问\n- 支持多项目内存库管理\n- 维护一致的文件结构和验证机制\n- 确保各项目内存库之间的适当隔离\n\n## 功能特性\n\n- **多项目支持**\n\n  - 项目专用目录\n  - 文件结构强制执行\n  - 防止路径遍历攻击\n  - 项目列表功能\n  - 按项目列出文件\n\n- **远程可访问性**\n\n  - 完整的 MCP 协议实现\n  - 类型安全的操作\n  - 合理的错误处理\n  - 通过项目隔离确保安全性\n\n- **核心操作**\n  - 读取\u002F写入\u002F更新内存库文件\n  - 列出可用项目\n  - 列出项目中的文件\n  - 验证项目是否存在\n  - 安全的只读操作\n\n## 安装\n\n要通过 [Smithery](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@alioshr\u002Fmemory-bank-mcp) 自动安装用于 Claude Desktop 的 Memory Bank 服务器：\n\n```bash\nnpx -y @smithery\u002Fcli install @alioshr\u002Fmemory-bank-mcp --client claude\n```\n\n这将自动设置 MCP 服务器配置。或者，您也可以按照下面的“配置”部分手动配置服务器。\n\n## 快速入门\n\n1. 在您的设置中配置 MCP 服务器（参见下方的“配置”部分）\n2. 开始在您的 AI 助手中使用内存库工具\n\n## 与 Cline\u002FRoo Code 配合使用\n\nMemory Bank MCP 服务器需要在您的 Cline MCP 设置文件中进行配置。具体位置取决于您的设置：\n\n- 对于 Cline 扩展：`~\u002FLibrary\u002FApplication Support\u002FCursor\u002FUser\u002FglobalStorage\u002Fsaoudrizwan.claude-dev\u002Fsettings\u002Fcline_mcp_settings.json`\n- 对于 Roo Code VS Code 扩展：`~\u002FLibrary\u002FApplication Support\u002FCode\u002FUser\u002FglobalStorage\u002Frooveterinaryinc.roo-cline\u002Fsettings\u002Fmcp_settings.json`\n\n将以下配置添加到您的 MCP 设置中：\n\n```json\n{\n  \"allpepper-memory-bank\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@allpepper\u002Fmemory-bank-mcp\"],\n    \"env\": {\n      \"MEMORY_BANK_ROOT\": \"\u003Cpath-to-bank>\"\n    },\n    \"disabled\": false,\n    \"autoApprove\": [\n      \"memory_bank_read\",\n      \"memory_bank_write\",\n      \"memory_bank_update\",\n      \"list_projects\",\n      \"list_project_files\"\n    ]\n  }\n}\n```\n\n### 配置详情\n\n- `MEMORY_BANK_ROOT`：存储项目内存库的目录（例如 `\u002Fpath\u002Fto\u002Fmemory-bank`）\n- `disabled`：设置为 `false` 以启用服务器\n- `autoApprove`：无需用户明确批准的操作列表：\n  - `memory_bank_read`：读取内存库文件\n  - `memory_bank_write`：创建新的内存库文件\n  - `memory_bank_update`：更新现有内存库文件\n  - `list_projects`：列出可用项目\n  - `list_project_files`：列出项目中的文件\n\n## 与 Cursor 配合使用\n\n对于 Cursor，请打开设置 -> 功能 -> 添加 MCP 服务器 -> 添加以下内容：\n\n```shell\nenv MEMORY_BANK_ROOT=\u003Cpath-to-bank> npx -y @allpepper\u002Fmemory-bank-mcp@latest\n```\n\n## 与 Claude 配合使用\n\n- Claude 桌面配置文件：`~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n- Claude Code 配置文件：`~\u002F.claude.json`\n\n1. 找到配置文件\n3. 找到名为 `mcpServers` 的属性\n4. 粘贴以下内容：\n\n```\n \"allPepper-memory-bank\": {\n          \"type\": \"stdio\",\n          \"command\": \"npx\",\n          \"args\": [\n            \"-y\",\n            \"@allpepper\u002Fmemory-bank-mcp@latest\"\n          ],\n          \"env\": {\n            \"MEMORY_BANK_ROOT\": \"YOUR PATH\"\n          }\n        }\n```\n\n## 自定义 AI 指令\n\n本节包含应粘贴到 AI 自定义指令中的指令，适用于 Cline、Claude 或 Cursor，以及其他任何 MCP 客户端。您应该复制并粘贴这些规则。有关参考，请参阅 [custom-instructions.md](custom-instructions.md)，其中包含了这些规则。\n\n## 开发\n\n基本开发命令：\n\n```bash\n# 安装依赖\nnpm install\n\n# 构建项目\nnpm run build\n\n# 运行测试\nnpm run test\n\n# 监视模式下运行测试\nnpm run test:watch\n\n# 使用 ts-node 直接运行服务器以快速测试\nnpm run dev\n```\n\n### 使用 Docker 运行\n\n1. 构建 Docker 镜像：\n\n    ```bash\n    docker build -t memory-bank-mcp:local .\n    ```\n\n2. 运行 Docker 容器进行测试：\n\n    ```bash\n    docker run -i --rm \\\n      -e MEMORY_BANK_ROOT=\"\u002Fmnt\u002Fmemory_bank\" \\\n      -v \u002Fpath\u002Fto\u002Fmemory-bank:\u002Fmnt\u002Fmemory_bank \\\n      --entrypoint \u002Fbin\u002Fsh \\\n      memory-bank-mcp:local \\\n      -c \"ls -la \u002Fmnt\u002Fmemory_bank\"\n    ```\n\n3. 添加 MCP 配置，例如针对 Roo Code：\n\n    ```json\n    \"allpepper-memory-bank\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \n        \"MEMORY_BANK_ROOT\",\n        \"-v\", \n        \"\u002Fpath\u002Fto\u002Fmemory-bank:\u002Fmnt\u002Fmemory_bank\",\n        \"memory-bank-mcp:local\"\n      ],\n      \"env\": {\n        \"MEMORY_BANK_ROOT\": \"\u002Fmnt\u002Fmemory_bank\"\n      },\n      \"disabled\": false,\n      \"alwaysAllow\": [\n        \"list_projects\",\n        \"list_project_files\",\n        \"memory_bank_read\",\n        \"memory_bank_update\",\n        \"memory_bank_write\"\n      ]\n    }\n    ```\n\n## 贡献\n\n欢迎贡献！请按照以下步骤操作：\n\n1. 分支仓库\n2. 创建功能分支 (`git checkout -b feature\u002Famazing-feature`)\n3. 提交更改 (`git commit -m '添加惊人功能'`)\n4. 推送到分支 (`git push origin feature\u002Famazing-feature`)\n5. 打开拉取请求\n\n### 开发指南\n\n- 所有新代码均使用 TypeScript\n- 维护整个代码库的类型安全性\n- 为新功能添加测试\n- 根据需要更新文档\n- 遵循现有代码风格和模式\n\n### 测试\n\n- 为新功能编写单元测试\n- 包含多项目场景测试\n- 彻底测试错误情况\n- 验证类型约束\n- 适当地模拟文件系统操作\n\n## 许可证\n\n本项目采用 MIT 许可证授权——详情请参阅 [LICENSE](LICENSE) 文件。\n\n## 致谢\n\n本项目实现了最初在[Cline Memory Bank](https:\u002F\u002Fgithub.com\u002Fnickbaumann98\u002Fcline_docs\u002Fblob\u002Fmain\u002Fprompting\u002Fcustom%20instructions%20library\u002Fcline-memory-bank.md)中记录的记忆库概念，并在此基础上扩展了远程功能和多项目支持。","# Memory Bank MCP 快速上手指南\n\nMemory Bank MCP Server 是一个基于模型上下文协议（MCP）的服务端实现，旨在将传统的基于文件的记忆库（Memory Bank）转化为集中式服务。它支持多项目管理、远程访问以及严格的文件结构验证，特别适用于 Cline、Roo Code 和 Cursor 等 AI 编程助手。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：macOS, Linux 或 Windows (WSL)\n*   **Node.js**：建议安装 LTS 版本（v18 或更高），用于运行 `npx` 命令。\n    *   检查版本：`node -v`\n*   **AI 客户端**：已安装并配置好支持 MCP 的客户端（如 Claude Desktop, Cline, Roo Code, 或 Cursor）。\n*   **存储目录**：规划一个本地目录用于存放记忆库文件（例如：`~\u002Fprojects\u002Fmemory-bank`）。\n\n## 安装步骤\n\n您可以选择通过 Smithery 自动安装，或手动配置 MCP 服务器。\n\n### 方式一：使用 Smithery 自动安装（推荐）\n\n如果您使用 Claude Desktop，可以通过 Smithery CLI 一键安装：\n\n```bash\nnpx -y @smithery\u002Fcli install @alioshr\u002Fmemory-bank-mcp --client claude\n```\n\n该命令会自动下载包并更新您的配置文件。\n\n### 方式二：手动配置\n\n如果自动安装不适用，或您需要自定义配置（如指定存储路径），请按以下步骤操作：\n\n1.  **找到配置文件**：\n    *   **Claude Desktop**: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json` (macOS) 或 `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows)\n    *   **Cline (VS Code)**: `~\u002FLibrary\u002FApplication Support\u002FCursor\u002FUser\u002FglobalStorage\u002Fsaoudrizwan.claude-dev\u002Fsettings\u002Fcline_mcp_settings.json`\n    *   **Roo Code (VS Code)**: `~\u002FLibrary\u002FApplication Support\u002FCode\u002FUser\u002FglobalStorage\u002Frooveterinaryinc.roo-cline\u002Fsettings\u002Fmcp_settings.json`\n    *   **Cursor**: 设置 -> Features -> MCP Servers -> Add New\n\n2.  **添加服务器配置**：\n    在配置文件的 `mcpServers` 对象中添加以下内容。请将 `\u003Cpath-to-bank>` 替换为您实际规划的存储目录绝对路径。\n\n    ```json\n    \"allpepper-memory-bank\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@allpepper\u002Fmemory-bank-mcp@latest\"],\n      \"env\": {\n        \"MEMORY_BANK_ROOT\": \"\u003Cpath-to-bank>\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": [\n        \"memory_bank_read\",\n        \"memory_bank_write\",\n        \"memory_bank_update\",\n        \"list_projects\",\n        \"list_project_files\"\n      ]\n    }\n    ```\n\n    *注：对于 Cursor，也可以在添加服务器时直接输入命令：`env MEMORY_BANK_ROOT=\u003Cpath-to-bank> npx -y @allpepper\u002Fmemory-bank-mcp@latest`*\n\n3.  **重启客户端**：保存配置文件并重启您的 AI 编辑器或桌面应用以加载新配置。\n\n## 基本使用\n\n配置完成后，Memory Bank MCP 服务器将在后台运行。您无需直接运行命令，而是通过与 AI 助手对话来管理记忆库。\n\n### 1. 创建或列出项目\n在聊天窗口中询问 AI：\n> \"列出所有可用的记忆库项目。\"\n> \"为我的新项目 'my-app' 创建一个记忆库。\"\n\nAI 将调用 `list_projects` 或 `memory_bank_write` 工具来执行操作。\n\n### 2. 读写记忆文件\n针对特定项目进行文档管理：\n> \"在 'my-app' 项目中读取 product-context.md 文件。\"\n> \"更新 'my-app' 项目的 progress.md，记录今天完成了登录功能。\"\n\nAI 会自动调用 `memory_bank_read` 或 `memory_bank_update` 工具，确保文件结构符合规范。\n\n### 3. 查看项目文件列表\n> \"显示 'my-app' 项目中所有的记忆文件。\"\n\n这将触发 `list_project_files` 工具，帮助您了解当前项目的文档结构。\n\n### 提示\n*   **自动批准**：配置中的 `autoApprove` 列表允许 AI 直接执行读写操作而无需每次确认，提升了流畅度。如需更高安全性，可从列表中移除相应权限。\n*   **隔离性**：不同项目的记忆库存储在独立的子目录中，互不干扰。","某全栈开发者同时维护三个微服务项目，需要 AI 助手在跨项目切换时准确记住每个项目的架构决策、待办事项和技术债务。\n\n### 没有 memory-bank-mcp 时\n- **上下文频繁丢失**：每次切换项目对话，AI 都会“失忆”，开发者不得不反复粘贴之前的架构文档或重新描述背景。\n- **文件管理混乱**：各项目的记忆文件散落在不同文件夹中，缺乏统一结构，AI 难以自动定位正确的参考文档。\n- **操作风险高**：AI 在尝试更新记忆文件时可能误写其他项目数据，缺乏隔离机制导致潜在的数据污染。\n- **协作效率低**：团队成员无法通过统一接口远程访问或验证特定项目的记忆库，只能依赖本地文件传输。\n\n### 使用 memory-bank-mcp 后\n- **上下文无缝衔接**：memory-bank-mcp 为每个项目建立独立目录，AI 通过 MCP 协议自动加载对应项目的记忆文件，切换项目时无需重复背景介绍。\n- **结构标准化**：强制统一的文件结构和路径校验，确保 AI 总能按预期读取“产品需求”或“技术栈”等关键信息。\n- **安全隔离保障**：内置的项目隔离机制防止路径遍历攻击，AI 只能在授权范围内读写，彻底杜绝误改其他项目数据的风险。\n- **远程协同增强**：支持远程访问和类型安全的操作，团队成员可直接让 AI 列出所有项目或检查特定文件的最新状态，协作更流畅。\n\nmemory-bank-mcp 将分散的本地笔记转化为集中、安全且可远程调用的智能记忆中枢，让 AI 真正成为懂项目历史的长期合作伙伴。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Falioshr_memory-bank-mcp_1b34dd0e.png","alioshr","Aliosh Romano","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Falioshr_7b2224bb.jpg","Daddy, husband, web developer and musician","Anova","Italy",null,"https:\u002F\u002Fgithub.com\u002Falioshr",[85,89,93],{"name":86,"color":87,"percentage":88},"TypeScript","#3178c6",99.3,{"name":90,"color":91,"percentage":92},"Dockerfile","#384d54",0.6,{"name":94,"color":95,"percentage":96},"JavaScript","#f1e05a",0.1,893,86,"2026-04-14T03:40:53","MIT","Linux, macOS, Windows","无 GPU 需求","未说明",{"notes":105,"python":103,"dependencies":106},"该工具是一个基于 Node.js 的 MCP 服务器，无需 Python 或 GPU。主要通过 npx 命令运行，需配置 MEMORY_BANK_ROOT 环境变量指定存储路径。支持直接运行或通过 Docker 容器部署。适用于 Cline、Roo Code、Cursor 和 Claude Desktop 等客户端。",[107,108],"Node.js (支持 npx)","npm",[14],[111,112,113,114,115,116,117,118,119],"antrophic","claude","cline","cursor","mcp-server","model-context-protocol","windsurf","memory-bank","cline-memory-bank","2026-03-27T02:49:30.150509","2026-04-19T03:06:38.560116",[123,128,133,138,143,148],{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},41472,"如何在 Claude Code 中安装和配置 Memory Bank MCP？","自动安装命令可能不起作用，建议手动配置。步骤如下：\n1. 进入用户根目录。\n2. 找到 `.claude.json` 文件。\n3. 找到 `mcpServers` 部分。\n4. 添加以下配置：\n```json\n\"allPepper-memory-bank\": {\n  \"type\": \"stdio\",\n  \"command\": \"npx\",\n  \"args\": [\n    \"-y\",\n    \"@allpepper\u002Fmemory-bank-mcp@latest\"\n  ],\n  \"env\": {\n    \"MEMORY_BANK_ROOT\": \"\u002FUsers\u002F你的用户名\u002Fpath\u002Fto\u002Fmemory-bank\"\n  }\n}\n```\n请确保将 `MEMORY_BANK_ROOT` 替换为你想要存储记忆库文件的实际路径。","https:\u002F\u002Fgithub.com\u002Falioshr\u002Fmemory-bank-mcp\u002Fissues\u002F21",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},41473,"为什么 Memory Bank 在 Claude Code 中不工作或没有创建文件？","LLM（大语言模型）具有非确定性，不能保证它会自动调用 MCP 工具。为了解决这个问题，你需要添加自定义指令（Custom Instructions）来强制 Claude 在使用 Memory Bank 时遵循特定模式：\n1. 创建一个 `CLAUDE.md` 文件或使用自定义命令功能。\n2. 将项目文档中提供的自定义指令内容粘贴进去。\n3. 这些指令会提示 Claude 在规划工作时查阅记忆库，并在工作完成后写入记忆库。\n如果不添加这些指令，Claude 可能会忽略该工具。","https:\u002F\u002Fgithub.com\u002Falioshr\u002Fmemory-bank-mcp\u002Fissues\u002F24",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},41474,"遇到 'Unexpected token M, \"Memory Ban\"... is not valid JSON' 错误怎么办？","这个错误通常是因为服务器将日志信息打印到了标准输出（stdout），而 MCP 协议期望所有非 JSON 日志信息打印到标准错误（stderr）。\n解决方案：\n1. 确保你安装的是最新版本的包（`@latest`），维护者已修复此问题，将日志输出重定向到了 stderr。\n2. 如果问题仍然存在，请检查你的配置，确保没有额外的脚本干扰输出流。\n3. 参考相关 Issue #21 确认配置是否正确。","https:\u002F\u002Fgithub.com\u002Falioshr\u002Fmemory-bank-mcp\u002Fissues\u002F17",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},41475,"使用 memory_bank_read 工具时报错 'The \"path\" argument must be of type string. Received undefined' 如何解决？","这个错误表明配置的环境变量 `MEMORY_BANK_ROOT` 指向的目录不存在。Memory Bank 工具不会自动创建目录。\n解决步骤：\n1. 检查你的配置文件中的 `MEMORY_BANK_ROOT` 路径（例如 `\u002FUsers\u002Fbogdan\u002F.claude\u002Fmemory`）。\n2. 手动在终端中创建该目录，例如运行：`mkdir -p \u002FUsers\u002Fbogdan\u002F.claude\u002Fmemory`。\n3. 确保该路径是绝对路径且当前用户有读写权限。\n4. 重启 Claude 或 MCP 服务后重试。","https:\u002F\u002Fgithub.com\u002Falioshr\u002Fmemory-bank-mcp\u002Fissues\u002F27",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},41476,"在 Amazon Q Developer 中启动时出现 'Mcp error: -32002: connection closed' 错误？","这是因为服务器在初始化时将状态信息打印到了标准输出（stdout），导致连接关闭。\n解决方法：\n1. 确保你使用的是最新版本的 `@allpepper\u002Fmemory-bank-mcp@latest`，维护者已经修复了此问题，将日志输出更改为标准错误（stderr）。\n2. 更新你的 `package.json` 或 MCP 配置中的版本号为 `@latest` 并重新安装。\n3. 如果问题依旧，尝试设置 `Q_LOG_LEVEL=trace` 查看更详细的日志以排查其他环境问题。","https:\u002F\u002Fgithub.com\u002Falioshr\u002Fmemory-bank-mcp\u002Fissues\u002F28",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},41477,"使用 Smithery CLI 安装时提示 'No connection configuration found' 怎么办？","这通常是因为目标配置文件（如 `cline_mcp_settings.json`）为空或不存在，导致 CLI 无法找到注入配置的位置。\n建议方案：\n1. 不要依赖自动安装脚本，直接手动编辑配置文件。\n2. 找到你的 MCP 客户端配置文件（例如 Cline 的 `cline_mcp_settings.json` 或 Claude 的 `.claude.json`）。\n3. 手动添加 `mcpServers` 配置块，填入 Memory Bank 的 stdio 配置（参考安装指南中的 JSON 片段）。\n4. 确保始终安装 `@latest` 版本以避免已知的兼容性问题。","https:\u002F\u002Fgithub.com\u002Falioshr\u002Fmemory-bank-mcp\u002Fissues\u002F8",[]]