Zntl MCP Server

🚀 Transcripter プロジェクト用 MCP サーバー

このサーバーは、Transcripter プロジェクト向けに実装された Model Context Protocol (MCP) サーバーです。このパッケージは、MCP 標準を使用して AI 駆動の機能を提供するツールとリソースを備えています。

✨ 主な機能

ツール

• test-api: API エンドポイントをテストし、結果を返します。
• transcription-search: フィルタリングとページングを使用して、トランスクリプション内容を検索します。
• transcription-summary: AI を使用して、トランスクリプション内容の要約を生成します。

リソース

• transcription://{id}: ID でトランスクリプションデータにアクセスします。
• analysis://{id}: ID で分析データにアクセスします。

📦 インストール

必要条件

• Node.js >= 18.0.0
• npm >= 7.0.0

インストールコマンド

npm install

ビルドコマンド

# ESM と CommonJS の両方をビルド
npm run build

# ESM のみをビルド
npm run build:esm

# CommonJS のみをビルド
npm run build:cjs

サーバー起動コマンド

# デフォルトポート (3500) で MCP サーバーを起動
npm run server

# カスタムポートで MCP サーバーを起動
npm run server 4000

テストコマンド

npm test

💻 使用例

基本的な使用法

test-api ツールの使用

import { Client } from "@modelcontextprotocol/sdk/client";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse";

async function testApiEndpoint() {
  // MCP サーバーに接続
  const transport = new SSEClientTransport("http://localhost:3500/sse", "http://localhost:3500/message");
  const client = new Client();
  await client.connect(transport);
  
  // test-api ツールを使用
  const result = await client.tools.execute("test-api", {
    endpoint: "transcriptions",
    method: "GET",
  });
  
  console.log(result);
}

トランスクリプションリソースの使用

import { Client } from "@modelcontextprotocol/sdk/client";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse";

async function getTranscription(id: number) {
  // MCP サーバーに接続
  const transport = new SSEClientTransport("http://localhost:3500/sse", "http://localhost:3500/message");
  const client = new Client();
  await client.connect(transport);
  
  // トランスクリプションリソースにアクセス
  const transcription = await client.resources.get(`transcription://${id}`);
  
  console.log(transcription);
}

📚 ドキュメント

Transcripter との統合

この MCP サーバーは Transcripter プロジェクトと統合されており、トランスクリプションと分析のための AI 駆動機能を提供します。AI モデルとのやり取りのための標準化されたインターフェースとして機能します。

プロジェクト構造

• src/cli.ts: MCP サーバーを起動するコマンドラインインターフェース
• src/tools/: MCP ツールの実装
• src/resources/: MCP リソースプロバイダーの実装
• src/tests/: ツールとリソースのテスト

📄 ライセンス

MIT