Uses git remote URLs to automatically identify and organize projects, ensuring knowledge is stored and retrieved in a project-aware context
Stores knowledge in YAML-frontmatter markdown documents with chapter-based organization for structured information management
Uses YAML frontmatter for document metadata in knowledge files, supporting properties like title and keywords for better organization
Knowledge MCP Server
A Model Context Protocol (MCP) server that provides centralized knowledge management for your projects. Store, search, and maintain project-specific knowledge that persists across sessions.
Features
- Project-aware: Automatically identifies projects by git remote URL
- Structured knowledge: Organize information in YAML-frontmatter markdown documents
- Full-text search: Search across all project knowledge documents
- Chapter-based organization: Structure documents with chapters for easy navigation
- Main instructions: Replace CLAUDE.md with centralized project instructions
- Secure: Path validation, input sanitization, and safe file operations
Installation
Via npx (recommended)
Via npm (global installation)
Requirements
- Node.js 14+
- Python 3.11+
- Git (for project identification)
Configuration
Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json
):
VSCode Claude Extension
Add to your VSCode settings:
Other MCP Clients
Usage
The Knowledge MCP Server provides the following tools:
Managing Project Instructions
- Get project instructions: Retrieve the main project instructions (replaces CLAUDE.md)
- Update project instructions: Create or update main project instructions
Knowledge Documents
- Create knowledge file: Create structured documents with metadata and chapters
- Search knowledge: Full-text search across all project documents
- Update chapter: Modify specific chapters within documents
- Delete knowledge file: Remove knowledge documents
Resources (Read-only)
knowledge://projects/{project_id}/main
- Read main project instructionsknowledge://projects/{project_id}/files
- List all knowledge filesknowledge://projects/{project_id}/chapters/{filename}
- List chapters in a document
Storage Location
Knowledge is stored in your home directory:
Document Format
Knowledge documents use YAML frontmatter with markdown content:
Development
Setup Development Environment
Testing with MCP Inspector
Building and Distribution
Security
- Path traversal protection
- Input sanitization for filenames
- Safe YAML parsing (no code execution)
- Atomic file writes
- Secure project identification
Troubleshooting
Python not found
Permission errors
MCP connection issues
Contributing
- Fork the repository
- Create a feature branch
- Run tests and code quality checks
- Submit a pull request
License
MIT License - see LICENSE file for details
Support
- GitHub Issues: https://github.com/sven-borkert/knowledge-mcp/issues
- MCP Documentation: https://modelcontextprotocol.io
This server cannot be installed
Provides centralized knowledge management for projects, allowing users to store, search, and maintain project-specific knowledge that persists across sessions.
Related MCP Servers
- -securityFlicense-qualityEnables management of development projects with GitHub integration, facilitating project tracking, repository linking, and metadata maintenance within the Model Context Protocol.Last updated -3JavaScript
- -securityAlicense-qualityProvides knowledge graph functionality for managing entities, relations, and observations in memory with strict validation rules to maintain data consistency.Last updated -6PythonMIT License
- -securityFlicense-qualityProvides tools for managing project knowledge graphs, enabling structured representation of projects, tasks, milestones, resources, and team members.Last updated -TypeScript
- -securityFlicense-qualityProvides tools for managing student knowledge graphs, enabling structured representation of courses, assignments, exams, concepts, and study resources.Last updated -TypeScript