Repository navigation
🎉 Major Refactor – v2.0.0
This release introduces a complete architectural overhaul of GitHub Second Brain, making it more modular, maintainable, and future-proof. All new development will continue from this version forward.
✨ What’s New
-
Self-contained MCP Server:
The MCP server is now implemented directly inmcp/main.py, removing the need for a separate FastAPI backend. This results in a simpler, more robust, and easier-to-deploy system. -
Async & Modern Python:
The new server useshttpxfor async HTTP requests and leverages Pydantic for type safety and validation. -
Modular Tooling:
All tools (directory tree, file contents, issue context) are now organized inmcp/tools/, making it much easier to extend and maintain. -
Simplified Dependencies:
Unnecessary dependencies have been removed. The project now relies onfastmcpandpydanticfor a leaner, more reliable stack. -
Improved Error Handling:
Enhanced error messages and validation for a better developer and user experience. -
Clear Documentation & Migration Guidance:
The README has been updated to reflect the new architecture, with clear instructions for both new and legacy users. New issue templates are also added and documented
🏷️ Branches
main: This branch contains the new, refactored codebase (v2.0.0+).legacy/v1-archive: The old architecture is preserved here for users who need it.
🚨 Migration & Support
-
Legacy users:
If you need the old FastAPI-based architecture, use thelegacy/v1-archivebranch or thev1.0.0-legacyrelease. -
New users:
Use themainbranch for the latest features, performance, and support. -
Migration guide:
See the README for details.
📝 Notes
- Please report any issues or suggestions via GitHub Issues.
- For legacy support, mention
v1.0.0-legacyin your issue.
Thank you for your support and contributions to GitHub Second Brain!
What's Changed
- Closes #42: Update README.md by @BaoNguyen09 in #48
- Closes #42: move all the logic from the fastapi server to within the mcp server container by @BaoNguyen09 in #47
Full Changelog: v1.0.0-legacy...v2.0.0