MCP提交

Generic MCP Server

一个基于TypeScript和Express的MCP服务器实现，用于连接AI代理与外部API，提供电影数据库交互功能，支持实时通信和模块化扩展。

娱乐与媒体开发者工具 #AI接口 #电影数据 #实时通信 #模块化本地 .TypeScript

2分

2025-04-29 01:25:21

概述

工具列表

内容详情

替代品

什么是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密钥?需要在TMDB官网注册开发者账号并申请API密钥

可以添加其他API吗?可以，通过扩展工具模块可以集成任意REST API

支持哪些AI模型?任何支持SSE协议和MCP规范的AI模型都可以使用

相关资源

MCP协议官方文档Model Context Protocol的完整规范说明

TMDB API文档电影数据库API参考

示例客户端代码演示如何连接MCP服务器的示例代码

精选MCP服务推荐

Firecrawl MCP Server

Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器，提供丰富的网页抓取、搜索和内容提取功能。

TypeScript

2,956

5分

Duckduckgo MCP Server

已认证

DuckDuckGo搜索MCP服务器，为Claude等LLM提供网页搜索和内容抓取服务

Framelink Figma MCP Server是一个为AI编程工具（如Cursor）提供Figma设计数据访问的服务器，通过简化Figma API响应，帮助AI更准确地实现设计到代码的一键转换。

TypeScript

6,102

4.5分

Edgeone Pages MCP Server

EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务

TypeScript

4.8分

Context7

Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务，通过Model Context Protocol直接集成到提示中，解决LLM使用过时信息的问题。

百度地图MCP Server是国内首个兼容MCP协议的地图服务，提供地理编码、路线规划等10个标准化API接口，支持Python和Typescript快速接入，赋能智能体实现地图相关功能。

Exa MCP Server是一个为AI助手（如Claude）提供网络搜索功能的服务器，通过Exa AI搜索API实现实时、安全的网络信息获取。

MiniMax Model Context Protocol (MCP) 是一个官方服务器，支持与强大的文本转语音、视频/图像生成API交互，适用于多种客户端工具如Claude Desktop、Cursor等。

Python

364

4.8分

通用 MCP 服务器

一个生产就绪的 Model Context Protocol (MCP) 服务器实现，使用 TypeScript 和 Express 构建，旨在无缝连接 AI 代理与外部 API。

概述

该项目展示了如何使用 @modelcontextprotocol/sdk 实现基于 Server-Sent Events (SSE) 的 MCP 服务器。它为开发人员提供了一个实用的参考，用于将 APIs 曝露给 AI 代理和大型语言模型（LLMs），重点在于电影数据库交互。

实现细节可在 src/mcp/tools.ts、src/mcp/prompts.ts、src/helpers/ 目录及相关文件中找到。

什么是 MCP？

Model Context Protocol (MCP) 建立了一个标准化接口，使 AI 模型能够安全高效地与外部系统交互。它定义了以下结构化的框架：

资源：模型可以访问的数据对象
工具：模型可以调用的可执行函数
提示：指导模型交互的模板

这种标准化简化了将 AI 功能集成到现有应用程序和服务中的过程。

更多文档请访问 Model Context Protocol 仓库。

关键功能

完整实现 MCP 规范
使用 Server-Sent Events (SSE) 实现实时通信
模块化架构，便于扩展
内置电影数据库集成，用于搜索人员和发现影片
API 响应的类型安全接口
全面错误处理
测试用例客户端作为参考

先决条件

Node.js 18 或更高版本
npm 或 yarn 包管理器

快速开始

安装

克隆仓库：

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 文件中指定的端口）可用。

API 参考

端点

端点	方法	描述
`/sse`	GET	用于 MCP 通信的服务器发送事件端点
`/messages`	POST	客户端向 MCP 服务器发送消息的端点

MCP 组件

资源

greeting://welcome：静态欢迎消息
users://{userId}：动态用户数据资源

工具

该服务器实现了强大的电影数据库工具：

movie_database_search_person：搜索演员、导演和其他电影从业人员，获取他们职业生涯、传记数据和电影作品的详细信息。
movie_database_discover_films：高级电影发现功能，基于筛选条件推荐影片。

提示

MCP 定义了一系列提示模板，用于指导 AI 代理与外部系统的交互。这些提示包括：

系统提示（System Prompt）：定义整个交互的上下文和目标。
用户提示（User Prompt）：具体的操作指令。
响应提示（Response Prompt）：规范 API 调用的结果格式。

电影数据库集成

服务器内置了对知名电影数据库的访问接口，支持以下操作：

搜索电影、演员和导演信息
获取电影详情及评价
查找电影院映片时间表
管理用户收藏列表

所有 API 调用均通过类型安全的接口进行封装，简化了开发流程。

贡献

欢迎贡献！请随意提交 Pull Request。

许可证

MIT

AIbase是一个专注于MCP服务的平台，为AI开发者提供高质量的模型上下文协议服务，助力AI应用开发。

简体中文

用户协议

隐私政策