MCP Plugin

MCP Plugin

MCP ツールをすばやく作成するためのスキャフォールドを提供する MCP プラグインプロジェクトです。mcp_server_exe のプラグイン開発に使用できます。

機能 | 機能

中国語	英語
MCP プラグインプロジェクトをすばやく作成できるコマンドラインツール	MCP プラグインプロジェクトをすばやく作成できるコマンドラインツール
基本的なツールの例を含む組み込みのデフォルトテンプレート	基本的なツールの例を含む組み込みのデフォルトテンプレート
TypeScript 開発環境をサポート	TypeScript 開発環境をサポート
テストフレームワーク（Jest）を統合	テストフレームワーク（Jest）を統合

インストール | インストール

グローバルインストール（推奨）| グローバルインストール（推奨）

npm install -g mcp-plugin

ローカルインストール | ローカルインストール

npm install mcp-plugin

使用方法 | 使用方法

新しいプロジェクトの作成 | 新しいプロジェクトの作成

# 创建新项目 | Create new project
mcp-plugin init

# 使用指定模板创建项目 | Create project with specific template
mcp-plugin init -t template-name

プロジェクトの作成中に、次の情報を入力するよう求められます。| プロジェクトの作成中に、次の情報を入力するよう求められます。

中国語	英語
プロジェクト名	プロジェクト名
プロジェクトの説明	プロジェクトの説明
作成者情報	作成者情報

MCP Server との統合 | MCP Server との統合

中国語：ビルド完了後、次の方法で MCP Server を起動し、プラグインを読み込むことができます。

英語：ビルド完了後、次の方法で MCP Server を起動し、プラグインを読み込むことができます。

mcp_server-win-x64.exe --mcp-js ./dist/index.js

フォームからツールを作成 | フォームからツールを作成

中国語	英語
ビジュアルフォームを使って、カスタムツールのコードをすばやく生成できます。	ビジュアルフォームを使って、カスタムツールのコードをすばやく生成できます。

mcp-plugin create

• 起動するとブラウザーが自動的に開き、ローカルのツール生成ページにアクセスします（デフォルトのポートは 3366 です）。| 起動するとブラウザーが自動的に開き、ローカルのツール生成ページにアクセスします（デフォルトのポートは 3366 です）。
• 左側でツール名、説明、パラメータフィールドを入力します。文字列、数値、ブール値、日付、列挙型など、複数の型に対応しています。| 左側でツール名、説明、パラメータフィールドを入力します。文字列、数値、ブール値、日付、列挙型など、複数の型に対応しています。
• 複数のパラメータフィールドを追加し、任意項目にするかどうかを設定できます。| 複数のパラメータフィールドを追加し、任意項目にするかどうかを設定できます。
• 中央の領域には、生成された TypeScript ツールコードとパラメータの例がリアルタイムで表示されます。| 中央の領域には、生成された TypeScript ツールコードとパラメータの例がリアルタイムで表示されます。
• 右側では、よく使われるテンプレートを選択してすぐに開始できます。| 右側では、よく使われるテンプレートを選択してすぐに開始できます。
• 「Copy Code」をクリックして生成されたコードをコピーし、プロジェクトの src/tools ディレクトリに貼り付けて使用します。

デフォルトテンプレートのツール例 | デフォルトテンプレートのツール例

1. test-echo

中国語	英語
機能：入力されたメッセージをそのまま返します	機能：入力されたメッセージをそのまま返します
パラメータ：message (string)	パラメータ：message (string)

2. get-current-time

中国語	英語
機能：現在時刻を取得します	機能：現在時刻を取得します
パラメータ：なし	パラメータ：なし

3. math-add

中国語	英語
機能：2 つの数値を加算します	機能：2 つの数値を加算します
パラメータ：	パラメータ：

• a (number)：1 つ目の数値 | - a (number)：1 つ目の数値
• b (number)：2 つ目の数値 | - b (number)：2 つ目の数値

カスタム開発 | カスタム開発

src ディレクトリ内でツールを編集したり、新しいツールを追加したりできます。各ツールでは、次の項目を実装する必要があります。

src ディレクトリ内でツールを編集したり、新しいツールを追加したりできます。各ツールでは、次の項目を実装する必要があります。

中国語	英語
ツール名	ツール名
ツールの説明	ツールの説明
パラメータスキーマ（zod を使用して定義）	パラメータスキーマ（zod を使用して定義）
ハンドラー関数	ハンドラー関数

例 | 例：

server.tool(
  'tool-name',           // 工具名称 | Tool name
  'Tool description',    // 工具描述 | Tool description
  {
    param: z.string()    // 参数定义 | Parameter definition
  },
  async (args) => {      // 处理函数 | Handler function
    // 实现逻辑 | Implementation logic
    return {
      content: [
        {
          type: 'text',
          text: 'result'
        }
      ]
    }
  }
)

プロジェクト開発 | プロジェクト開発

中国語	英語

1. プロジェクトディレクトリに移動：| 1. プロジェクトディレクトリに移動：

cd your-project-name

2. 依存関係をインストール：| 2. 依存関係をインストール：

npm install

3. 開発モード：| 3. 開発モード：

npm run dev

4. プロジェクトをビルド：| 4. プロジェクトをビルド：

npm run build

5. テストを実行：| 5. テストを実行：

npm test

ライセンス | ライセンス

Apache