Yt MCP Server

🚀 Yt-mcp-server

このプロジェクトは、mcp-frameworkを使用して構築されたモデルコンテキストプロトコル (MCP) サーバーです。

🚀 クイックスタート

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

📁 プロジェクト構造

yt-mcp-server/
├── src/
│   ├── tools/        # MCP ツール
│   │   └── ExampleTool.ts
│   └── index.ts      # サーバーのエントリーファイル
├── package.json
└── tsconfig.json

➕ コンポーネントの追加

プロジェクトには、src/tools/ExampleTool.tsにサンプルツールが付属しています。CLIを使用して、さらに多くのツールを追加できます。

# 新しいツールの追加
mcp add tool my-tool

# 作成する可能性のあるサンプルツール:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

💻 ツール開発

サンプルツールの構造は次の通りです。

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "ツールの機能を説明する";

  schema = {
    message: {
      type: z.string(),
      description: "この入力パラメーターの説明",
    },
  };

  async execute(input: MyToolInput) {
    // ツールのロジックをここに記述
    return `処理後：${input.message}`;
  }
}

export default MyTool;

📦 npmへの公開

1. package.jsonを更新する：

   • nameが一意で、npmの命名規則に従っていることを確認する
   • 適切なversionを設定する
   • description、author、licenseなどを追加する
   • binが正しいエントリーファイルを指していることを確認する

2. ローカルでのビルドとテスト：

   npm run build
   npm link
   yt-mcp-server  # ローカルでCLIをテストする
   

3. npmにログインする（必要に応じてアカウントを作成する）：

   npm login
   

4. パッケージを公開する：

   npm publish
   

公開後、ユーザーは以下の方法でClaudeデスクトップクライアントに追加するか、npxを使用して実行できます。

🔌 Claude Desktopとの統合

ローカル開発時

Claude Desktopの設定ファイルに以下の内容を追加します。

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "yt-mcp-server": {
      "command": "node",
      "args":["/絶対パス/到/yt-mcp-server/dist/index.js"]
    }
  }
}

公開後

Claude Desktopの設定ファイルに以下の内容を追加します。

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "yt-mcp-server": {
      "command": "npx",
      "args": ["yt-mcp-server"]
    }
  }
}

🔨 ビルドとテスト

1. ツールのコードを変更する
2. npm run buildを実行してコンパイルする
3. サーバーを起動すると、自動的にツールが読み込まれます

📖 詳細を学ぶ

• MCP フレームワーク Github
• MCP フレームワークドキュメント