Obsidian Dictionary MCP

🚀 Obsidian Dictionary MCP Server

Obsidianボールト内で技術用語辞書を管理するためのMCPサーバーです。

🚀 クイックスタート

このセクションでは、Obsidian Dictionary MCP Serverのインストールと設定方法を説明します。

📦 インストール

1. ビルド

cd obsidian-dictionary-mcp
npm install
npm run build

2. Claude Desktopの設定

~/Library/Application Support/Claude/claude_desktop_config.json ファイルを開き、以下を追加してください:

{
  "mcpServers": {
    "dict": {
      "command": "node",
      "args": [
        "/path/to/obsidian-dictionary-mcp/dist/index.js",
        "--glossary-path",
        "/path/to/your/ObsidianVault/Glossary/개발용어사전.md"
      ]
    }
  }
}

3. Claude Code (CLI)の設定

Claude Code CLIで使用するには、2つの方法 から1つを選択してください:

方法A: プロジェクトごとの設定 (推奨)

プロジェクトのルートに .mcp.json ファイルを作成します:

{
  "mcpServers": {
    "dict": {
      "command": "node",
      "args": [
        "/path/to/obsidian-dictionary-mcp/dist/index.js",
        "--glossary-path",
        "/path/to/your/ObsidianVault/Glossary/개발용어사전.md"
      ]
    }
  }
}

方法B: グローバル設定

~/.claude/settings.json ファイルに以下を追加します:

{
  "mcpServers": {
    "dict": {
      "command": "node",
      "args": [
        "/path/to/obsidian-dictionary-mcp/dist/index.js",
        "--glossary-path",
        "/path/to/your/ObsidianVault/Glossary/개발용어사전.md"
      ]
    }
  }
}

⚠️ 重要な注意

設定ファイルを作成または編集した後は、Claude Codeを再起動 する必要があります。MCPサーバーはClaude Codeが起動するときに設定を読み取って実行されるためです。

--glossary-path オプション

--glossary-path オプションでデフォルトの用語集パスを設定すると:

• ツールを呼び出すときに file_path パラメータを 省略 できます
• 設定しない場合は、毎回 file_path を指定する必要があります

💻 使用例

利用可能なツール

append_entry

新しい用語を辞書に追加します。

パラメータ:

• file_path (オプション): 辞書ファイルのパス (デフォルトパスを設定した場合は省略可能)
• term: 追加する用語
• dev_explanation: 開発者向けの説明 (韓国語、1 - 2文)
• simple_explanation: 非開発者向けの説明 (韓国語、1文)
• example: 例 (韓国語、1行)

search_entry

用語がすでに存在するかどうかを確認します。

パラメータ:

• file_path (オプション): 辞書ファイルのパス (デフォルトパスを設定した場合は省略可能)
• term: 検索する用語

get_entry

特定の用語の内容のみを取得します (ファイル全体ではなく)。

パラメータ:

• file_path (オプション): 辞書ファイルのパス (デフォルトパスを設定した場合は省略可能)
• term: 取得する用語

list_terms

辞書に含まれるすべての用語のリストを返します (用語名のみ、内容ではなく)。

パラメータ:

• file_path (オプション): 辞書ファイルのパス (デフォルトパスを設定した場合は省略可能)

📚 詳細ドキュメント

辞書エントリの形式

### {term}
- 開発者向け説明: {開発者の観点からの説明}
- 非開発者向け説明: {簡単な説明}
- 例: {短い例}

Obsidian Vaultのパス

辞書ファイルのパスの例:

/path/to/your/ObsidianVault/Glossary/개발용어사전.md