Claude MCP Servers

🚀 クラウディオガイド

このガイドは、クラウディオのインストール、設定、使用方法について説明します。

🚀 クイックスタート

📦 インストール

依存関係のインストール

Bunを使用して依存関係をインストールします。

bun add ts-mdx @types/node zod

サーバーの起動

プロジェクトのルートディレクトリで以下のスクリプトを作成して実行します。

#!/bin/bash
BUN_PATH=./node_modules/.bun/bun
$BUN_PATH run ./src/server.ts

🔧 環境変数の設定

.envファイルを編集し、以下の内容を追加します。

OBSIDIAN_VAULT_DIR=/path/to/obsidian/vault

💻 使用例

基本的な使用法

Obsidian機能

ノートの書き込み

write_note({
  "path": "Projects/新项目",
  "content": "# 新项目\n\n此处记录项目细节。",
  "append": true
})

ノートの削除

delete_note({
  "path": "Projects/旧项目"
})

ノートの読み取り

read_notes({
  "paths": ["Projects/新项目", "Daily/2025-04-12"]
})

ノートの検索

search_notes({
  "query": "项目"
})

📚 ドキュメント

MCP開発ガイド

新しいMCPファイルの作成

/ts/src/ディレクトリに新しい.tsファイルを作成し、既存のファイル（例：obsidian.ts）を参考にします。

パラメータモードの定義

Zodを使用して入力パラメータを定義します。

const MyToolArgsSchema = z.object({
  param1: z.string().describe("参数1描述"),
  param2: z.number().optional().describe("可选参数2")
});

ツール機能の実装

server.setRequestHandler()で具体的なロジックを実装します。

設定ファイルの更新

claude_desktop_config.template.jsonとcursor_config.template.jsonを編集し、新しいMCP設定を追加します。

"my-new-tool": {
  "command": "{{BUN_PATH}}",
  "args": ["运行", "{{PROJECT_ROOT}}/ts/src/my-new-tool.ts", "{{SOME_PARAMETER}}"]
}

環境変数の追加

必要に応じて.envファイルに新しい環境変数を追加し、READMEドキュメントを更新して説明を追加します。

🔧 よくある問題の解決

• コマンドライン出力の検証：エラーメッセージがないか確認します。
• .envファイルのパスの確認：正しい位置にあることを確認します。
• Bunの正常動作の確認：簡単なコマンドを実行してテストします。
• Obsidian機能のvaultパスの確認：OBSIDIAN_VAULT_DIRが正しく設定されていることを確認します。
• 対話型インストール問題の処理：make setupを使用して従来のインストールを試みます。

🔍 開発理念

このプロジェクトでは、Bunのみをパッケージ管理ツールとして使用しており、npmやyarnなどの他のツールはサポートされていません。すべてのインストールと実行操作はbunコマンドを通じて行う必要があります。