Adonis MCP

Adonis MCP

Adonis MCP は、Model Context Protocol（MCP）をサポートする AdonisJS フレームワーク向けのパッケージです。このパッケージを使うと、Server-Sent Events（SSE）を使用するリモート MCP サーバーを簡単に構築できます。

インストール

次のコマンドを実行して、パッケージをインストールします。

node ace add @7nohe/adonis-mcp

設定

インストール後、config/mcp.ts ファイルが生成されます。このファイルを編集して、MCP サーバーの設定をカスタマイズします。

例：

import { defineConfig } from '@7nohe/adonis-mcp'

export default defineConfig({
  ssePath: '/sse',
  messagesPath: '/messages',
  serverOptions: {
    name: 'mymcp',
    version: '0.0.1',
  },
})

使用方法

ルートの登録

start/routes.ts の registerRoutes メソッドを使って、ツールとプロンプトを定義できます。以下はその例です。

import mcp from '@7nohe/adonis-mcp/services/main'
import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js'
import { z } from 'zod'

await mcp.registerRoutes((server) => {
  server.resource(
    'echo',
    new ResourceTemplate('echo://{message}', { list: undefined }),
    async (uri, { message }) => ({
      contents: [
        {
          uri: uri.href,
          text: `Resource echo: ${message}`,
        },
      ],
    })
  )

  server.tool('echo', { message: z.string() }, async ({ message }) => ({
    content: [{ type: 'text', text: `Tool echo: ${message}` }],
  }))

  server.prompt('echo', { message: z.string() }, ({ message }) => ({
    messages: [
      {
        role: 'user',
        content: {
          type: 'text',
          text: `Please process this message: ${message}`,
        },
      },
    ],
  }))
})

サーバーの起動

ルートを定義したら、次のコマンドを実行して MCP サーバーを起動します。

npm run dev

デバッグ

設定ファイルを使用する

デバッグするには、MCP サーバーの設定ファイル（Claude Desktop や Cursor 用など）を次のように編集します。

{
  "mcpServers": {
    "mymcp": {
      "url": "http://localhost:3333/sse"
    }
  }
}

Inspector を使用する

Inspector を使う方法もあります。次のコマンドで起動します。

npx @modelcontextprotocol/inspector

1. トランスポートタイプを SSE に設定します。
2. URL http://localhost:3333/sse を入力します。
3. Connect ボタンをクリックします。
4. ステータスが Connected に変わることを確認します。

詳細については、Inspector のドキュメントを参照してください。

ライセンス

このプロジェクトは、MIT ライセンスの下で提供されています。