zerogon1203/obsidian-mcp-server
3.2
If you are the rightful owner of obsidian-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
OBSIDIAN-MCP-SERVER is a Model Context Protocol (MCP) Stdio server that integrates with LLM Agents to provide Python-based Obsidian functionalities.
OBSIDIAN-MCP-SERVER
LLM Agentμ μ°λ κ°λ₯ν Model Context Protocol (MCP) Stdio μλ²μ λλ€. μ΄ μλ²λ LLM Agentκ° Obsidian κ΄λ ¨ κΈ°λ₯μ νμ©ν μ μλλ‘ Python κΈ°λ°μ Obsidian κ΄λ ¨ κΈ°λ₯λ€μ μ 곡ν©λλ€.
κΈ°λ₯
Vault κ΄λ¦¬
- Vault μμ±
- Vault μμ
- Vault λͺ©λ‘ μ‘°ν
- Vault μ 보 μ‘°ν
- Vault μ€μ μ‘°ν
- Vault μ€μ λ³κ²½
νμΌ κ΄λ¦¬
- Vault νμΌ λͺ©λ‘ μ‘°ν
- Vault νμΌ μμ±(μμ±/μμ )
- Vault νμΌ μμ
μ€μΉ λ°©λ²
- μ μ₯μ ν΄λ‘
git clone https://github.com/your-username/obsidian-mcp-server.git
cd obsidian-mcp-server
- κ°μ νκ²½ μμ± λ° νμ±ν
python -m venv venv
source venv/bin/activate # Linux/Mac
# λλ
.\venv\Scripts\activate # Windows
- μμ‘΄μ± μ€μΉ
pip install -r requirements.txt
- νκ²½ λ³μ μ€μ
.envνμΌμ μμ±νκ³ λ€μ λ΄μ©μ μΆκ°ν©λλ€:
OBSIDIAN_VAULT_PATH=/path/to/your/obsidian/vault
μ¬μ© λ°©λ²
μλ² μ€ν
python main.py
API μ¬μ© μμ
Vault μμ±
{
"jsonrpc": "2.0",
"method": "create_vault",
"params": {
"vault_name": "my_vault",
"path": "/optional/custom/path"
},
"id": 1
}
Vault λͺ©λ‘ μ‘°ν
{
"jsonrpc": "2.0",
"method": "list_vaults",
"params": {},
"id": 2
}
νμΌ μμ±
{
"jsonrpc": "2.0",
"method": "write_vault_file",
"params": {
"vault_name": "my_vault",
"file_path": "notes/example.md",
"content": "# Example Note\n\nThis is a test note."
},
"id": 3
}
μλ¬ μ½λ
- -32000: μΌλ° μ€λ₯
- -32001: Vaultλ₯Ό μ°Ύμ μ μμ
- -32002: Vaultκ° μ΄λ―Έ μ‘΄μ¬ν¨
- -32003: νμΌμ μ°Ύμ μ μμ
- -32004: κ²½λ‘λ₯Ό μ°Ύμ μ μμ
- -32005: μ€μ νμΌμ μ°Ύμ μ μμ
- -32006: μλͺ»λ μ€μ
- -32007: νμΌ μμ μ€λ₯
- -32008: μλͺ»λ μμ²
- -32009: νκ²½ λ³μ μ€μ μ€λ₯
- -32010: Obsidian λλ ν 리 μ€λ₯
μλ΅ νμ
μ±κ³΅ μλ΅
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"status": "success",
"message": "Operation completed successfully",
"data": {}
}
}
μ€λ₯ μλ΅
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32001,
"message": "Vault 'my_vault' does not exist"
}
}
λΌμ΄μ μ€
MIT License
Cursor μ€μΉ λ°©λ²
Cursorμμ μ΄ MCP μλ²λ₯Ό μ¬μ©νλ €λ©΄ λ€μκ³Ό κ°μ΄ μ€μ νμΈμ:
"obsidian-mcp-server": {
"transport": "stdio",
"command": "/path/to/your/venv/bin/python",
"args": ["/path/to/your/obsidian-mcp-server/main.py"],
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
}
}
κ° κ²½λ‘λ₯Ό μμ μ νκ²½μ λ§κ² μμ νμΈμ:
/path/to/your/venv/bin/python: Python κ°μνκ²½μ Python μ€ν νμΌ κ²½λ‘/path/to/your/obsidian-mcp-server/main.py: μ΄ νλ‘μ νΈμ main.py νμΌ κ²½λ‘/path/to/your/obsidian/vault: Obsidian Vault κ²½λ‘
