Generic MCP Server

一個基於TypeScript和Express的MCP服務器實現，用於連接AI代理與外部API，提供電影數據庫交互功能，支持即時通信和模塊化擴展。

娛樂與媒體開發者工具 #AI接口 #電影數據 #即時通信 #模塊化本地 .TypeScript

評分 : 2分

下載量 : 9

更新時間 : 2025-04-29

什麼是MCP服務器?

MCP服務器是一個標準化接口，讓AI模型能夠安全高效地與外部系統交互。它提供結構化框架來管理資源、工具和提示模板，特別適合將AI能力集成到現有應用中。

如何使用MCP服務器?

只需三步即可開始使用：1) 安裝Node.js環境 2) 配置API密鑰 3) 運行服務器。之後AI代理就可以通過SSE協議與服務器交互，訪問電影數據庫等功能。

適用場景

最適合需要AI訪問外部數據的場景，如：電影推薦系統、演員信息查詢、智能客服集成、以及任何需要LLM與API交互的應用開發。

主要功能

即時數據流通過Server-Sent Events(SSE)實現即時通信，適合持續數據更新場景

電影數據庫集成內置The Movie Database(TMDB)API訪問，支持演員搜索和電影發現

模塊化架構易於擴展的設計，可以快速添加新工具和資源

類型安全接口使用TypeScript確保API響應數據的類型安全

優勢與侷限性

優勢

標準化協議確保與各種AI框架兼容

即時通信能力提升交互體驗

詳細的電影數據訪問功能

完善的錯誤處理和類型安全

侷限性

目前主要面向電影相關數據

需要Node.js環境運行

部分高級功能需要TMDB API密鑰

如何使用

環境準備

安裝Node.js 18或更高版本

獲取項目

克隆倉庫並安裝依賴

配置

複製示例環境文件並添加TMDB API密鑰

運行服務器

啟動開發服務器(帶熱重載)

使用案例

演員作品查詢查詢某演員參與過的所有電影作品

電影推薦根據條件推薦適合的電影

常見問題

如何獲取TMDB API密鑰?

可以添加其他API嗎?

支持哪些AI模型?

🚀 通用 MCP 服務器

本項目是一個生產就緒的 Model Context Protocol (MCP) 服務器實現，採用 TypeScript 和 Express 構建，能讓 AI 代理與外部 API 實現無縫連接，為 AI 功能集成提供了便利。

🚀 快速開始

安裝

克隆倉庫：

git clone https://github.com/yourusername/generic-mcp-server.git
cd generic-mcp-server

安裝依賴項：
```
npm install
```
配置環境：
```
cp .env.example .env
```

將 API 憑據添加到 .env 文件中：

PORT=8089
ACCESS_TOKEN=your_movie_db_access_token

運行服務器

開發模式（帶熱重載）：

npm run dev

生產模式：

npm run build
npm start

服務器將在 http://localhost:8089（或 .env 文件中指定的端口）可用。

✨ 主要特性

完整實現 MCP 規範
使用 Server-Sent Events (SSE) 實現即時通信
模塊化架構，便於擴展
內置電影數據庫集成，用於搜索人員和發現影片
API 響應的類型安全接口
全面錯誤處理
測試用例客戶端作為參考

📦 安裝指南

安裝步驟

克隆倉庫：

git clone https://github.com/yourusername/generic-mcp-server.git
cd generic-mcp-server

安裝依賴項：
```
npm install
```
配置環境：
```
cp .env.example .env
```

將 API 憑據添加到 .env 文件中：

PORT=8089
ACCESS_TOKEN=your_movie_db_access_token

運行模式

開發模式（帶熱重載）：

npm run dev

生產模式：

npm run build
npm start

📚 詳細文檔

概述

該項目展示瞭如何使用 @modelcontextprotocol/sdk 實現基於 Server-Sent Events (SSE) 的 MCP 服務器。它為開發人員提供了一個實用的參考，用於將 APIs 曝露給 AI 代理和大型語言模型（LLMs），重點在於電影數據庫交互。實現細節可在 src/mcp/tools.ts、src/mcp/prompts.ts、src/helpers/ 目錄及相關文件中找到。