hint-services/obsidian-github-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
MCP Server to search individual private Github Repositories
概要
A Model Context Protocol (MCP) server that connects AI assistants to GitHub repositories containing Obsidian vaults. This server enables seamless integration with your knowledge base stored on GitHub, allowing AI assistants to read, search, and analyze your Obsidian notes and documentation. Many Obsidian users store their vaults in GitHub for backup, versioning, and collaboration. This MCP server bridges the gap between your GitHub-hosted Obsidian vault and AI assistants, enabling: - : Retrieve specific notes and documents from your Obsidian vault - : Find relevant content across your entire knowledge base - : See how your ideas and notes have developed over time - : Connect with issues and project management workflows - : Connect to any GitHub repository containing your Obsidian vault - : Written in TypeScript with comprehensive type definitions - : Robust validation for all API inputs using Zod schemas - : Graceful error handling with informative messages - : Full compatibility...
README
以下は原文 README の抜粋です。原文を見る。
Obsidian GitHub MCP
A Model Context Protocol (MCP) server that connects AI assistants to GitHub repositories containing Obsidian vaults. This server enables seamless integration with your knowledge base stored on GitHub, allowing AI assistants to read, search, and analyze your Obsidian notes and documentation.
Why This Tool?
Many Obsidian users store their vaults in GitHub for backup, versioning, and collaboration. This MCP server bridges the gap between your GitHub-hosted Obsidian vault and AI assistants, enabling:
- Knowledge Base Access: Retrieve specific notes and documents from your Obsidian vault
- Intelligent Search: Find relevant content across your entire knowledge base
- Evolution Tracking: See how your ideas and notes have developed over time
- Task Integration: Connect with issues and project management workflows
Features
- GitHub Repository Access: Connect to any GitHub repository containing your Obsidian vault
- Type-Safe Implementation: Written in TypeScript with comprehensive type definitions
- Input Validation: Robust validation for all API inputs using Zod schemas
- Error Handling: Graceful error handling with informative messages
- MCP Integration: Full compatibility with Claude, Cursor, Windsurf, Cline, and other MCP hosts
Available Tools
Knowledge Base Access
- getFileContents: Retrieve the contents of specific notes, documents, or files from your Obsidian vault
- searchFiles: Enhanced search with multiple modes:
filename: Find files by exact filename (perfect for “OKR 2025” type searches)path: Search anywhere in file pathscontent: Search within file contentsall: Comprehensive search across filenames, paths, and content
Project Management Integration
- searchIssues: Search for issues and discussions related to your knowledge base projects
- getCommitHistory: Track how your knowledge base has evolved over time with detailed commit history and diffs
Use Cases
For Knowledge Workers
- Research Assistant: AI can access your research notes and reference materials
- Writing Support: Pull relevant background information from your knowledge base
- Idea Development: Track how concepts have evolved across your notes
For Developers
- Documentation Access: Retrieve project documentation and technical notes
- Learning Journals: Access your learning notes and code examples
- Project Planning: Integrate with GitHub issues for comprehensive project management
For Students & Academics
- Study Materials: Access lecture notes and study guides
- Research Papers: Retrieve research notes and citations
インストール
npx -y obsidian-github-mcp設定
{
"mcpServers": {
"obsidianGithub": {
"command": "npx",
"args": ["-y", "obsidian-github-mcp"],
"env": {
"GITHUB_TOKEN": "your-github-token",
"GITHUB_OWNER": "your-github-username",
"GITHUB_REPO": "your-obsidian-vault-repo"
}
}
}
}