Power your agent
URL của chính nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
https://server.smithery.ai/@Hint-Services/obsidian-github-mcp/mcpNút Claude ở trên mở Claude với tên và URL đã được điền sẵn. Bạn vẫn cần xác nhận tại đó.
claude mcp add --transport http hint-services-obsidian-github-mcp https://server.smithery.ai/@Hint-Services/obsidian-github-mcp/mcpRun in a terminal.
{ "mcpServers": { "hint-services-obsidian-github-mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://server.smithery.ai/@Hint-Services/obsidian-github-mcp/mcp" ] } }}claude_desktop_config.json
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
MởTừ nhà phát hành
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.
MCP Server to search individual private Github Repositories
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:
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 contentThe easiest way to install Obsidian GitHub MCP is using Smithery:
# For Claude Desktop
npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client claude
# For Cursor
npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client cursor
# For Windsurf
npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client windsurf
# For Cline
npx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client cline
npm install obsidian-github-mcp
Add the server to your MCP settings file with the following configuration:
{
"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"
}
}
}
}
GITHUB_TOKEN: Your GitHub personal access token (create one here)GITHUB_OWNER: The owner/organization of the GitHub repositoryGITHUB_REPO: The name of the repository containing your Obsidian vaultYour GitHub token needs the following permissions:
repo (for private repositories) or public_repo (for public repositories)read:org (if accessing organization repositories){
"tool": "getFileContents",
"arguments": {
"filePath": "Daily Notes/2024-01-15.md"
}
}
{
"tool": "searchFiles",
"arguments": {
"query": "OKR 2025",
"searchIn": "filename"
}
}
{
"tool": "searchFiles",
"arguments": {
"query": "Daily Notes",
"searchIn": "path"
}
}
{
"tool": "searchFiles",
"arguments": {
"query": "machine learning algorithms",
"searchIn": "content",
"perPage": 10
}
}
{
"tool": "searchFiles",
"arguments": {
"query": "project planning",
"searchIn": "all"
}
}
{
"tool": "searchFiles",
"arguments": {
"query": "path:*.md extension:md",
"searchIn": "content"
}
}
{
"tool": "getCommitHistory",
"arguments": {
"days": 30,
"includeDiffs": true,
"maxCommits": 10
}
}
Problem: Searching for "OKR 2025" doesn't find your file named "OKR 2025.md"
Solution: Use the searchIn: "filename" parameter:
{
"tool": "searchFiles",
"arguments": {
"query": "OKR 2025",
"searchIn": "filename"
}
}
Exact Phrases: Use quotes for multi-word searches
{
"query": "\"project planning 2025\"",
"searchIn": "content"
}
File Extensions: Find specific file types
{
"query": "path:*.md",
"searchIn": "content"
}
Directory Specific: Search within folders
{
"query": "path:\"Daily Notes/\"",
"searchIn": "content"
}
obsidian-github-mcp/
├── src/
│ ├── index.ts # Main MCP server entry point
│ └── github/ # GitHub API integration
│ ├── client.ts # GitHub client implementation
│ └── types.ts # TypeScript type definitions
├── docs/ # Documentation
├── package.json # Project configuration
└── tsconfig.json # TypeScript configuration
If you're interested in contributing to this project or developing your own tools with this server, please see the Development Guide.
pnpm install - Install dependenciespnpm run build - Build the projectpnpm run dev - Run in development mode with inspectorpnpm run inspector - Launch MCP inspector for testingIf you're migrating from the older mcp-private-github-search package:
Update your package name in configuration:
{
"mcpServers": {
"obsidianGithub": {
"command": "npx",
"args": ["-y", "obsidian-github-mcp"]
}
}
}
The functionality remains the same - all existing tools work identically
Consider the new Obsidian-focused use cases and workflows
For further information on the MCP ecosystem, refer to:
"The future is already here, it's just unevenly distributed"
— William Gibson, Author
Hint Services is a boutique consultancy with a mission to develop and expand how user interfaces leverage artificial intelligence technology. We architect ambition at the intersection of AI and User Experience, founded and led by Ben Hofferber.
We offer specialized AI workshops for design teams looking to embrace AI tools without becoming developers. Learn more about our training and workshops.
MCP Server to search individual private Github Repositories
{ "mcpServers": { "hint-services-obsidian-github-mcp": { "url": "https://server.smithery.ai/@Hint-Services/obsidian-github-mcp/mcp", "headers": {} } }}Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình http cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Obsidian Github được truy cập qua HTTP.
Kiểm tra lần cuối: 2026-10-28. MCP Server to search individual private Github Repositories
