Zntl MCP Server

🚀 MCP 服務器用於 Transcripter 項目

本項目為 Transcripter 項目實現了一個 Model Context Protocol (MCP) 服務器。該軟件包提供了基於 MCP 標準實現 AI 驅動功能的工具和資源，助力項目高效運行。

🚀 快速開始

此 MCP 服務器為 Transcripter 項目提供了強大的 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 許可證。