项目简介
本项目是一个基于Model Context Protocol (MCP) 实现的服务器端应用,旨在为连接的LLM客户端提供访问在线动漫列表数据的能力。它通过注册一个标准的MCP工具,允许LLM或其他客户端按需获取动漫列表信息。
主要功能点
- 提供动漫列表查询工具: 注册了一个名为 'list-anime' 的MCP工具。
- 获取在线数据: 该工具能够调用外部API('https://listanime-umber.vercel.app/api/listanimes')获取实时的动漫列表数据。
- 结构化数据输出: 将获取到的动漫数据以JSON格式返回给调用工具的MCP客户端。
安装步骤
- 安装Node.js: 确保您的系统已安装Node.js环境。
- 初始化项目: 在项目目录下运行 'npm -y init' 初始化npm项目。
- 配置模块类型: 在生成的 'package.json' 文件中添加 '"type": "module"'。
- 安装依赖: 运行以下命令安装必要的库:
npm install @modelcontextprotocol/sdk zod - 放置代码: 将提供的 'main.ts' 代码保存到项目根目录。
服务器配置
该MCP服务器通常由MCP客户端(如支持MCP的VSCode扩展、独立的LLM应用等)启动和管理。客户端需要知道如何运行这个服务器程序。
MCP客户端通常通过一个配置对象来指定服务器信息,至少包括服务器名称、启动命令及参数。
- 服务器名称: 'MCPlistanime'
- 启动命令 (command): 'npx'
- 参数 (args): '["-y", "tsx", "您的main.ts文件路径"]' (请将 '"您的main.ts文件路径"' 替换为您实际保存 'main.ts' 文件的完整路径)
配置示例(伪代码,具体格式取决于客户端):
{ "server_name": "MCPlistanime", "start_command": "npx", "start_args": ["-y", "tsx", "/path/to/your/mcp-listanime/main.ts"] }
客户端会根据此配置在需要时启动服务器并通过Stdio与之通信。
基本使用方法
- 配置客户端: 在您的MCP客户端中,按照上述“服务器配置”说明添加本服务器的配置信息。
- 连接服务器: 启动客户端,客户端会自动根据配置尝试连接并启动MCPlistanime服务器。
- 调用工具: 通过客户端的接口或LLM的功能,调用名为 'list-anime' 的工具。该工具当前接受一个名为 'ask' 的字符串参数(尽管在代码中未被用于过滤,但定义中存在)。
- 获取结果: 工具执行后会返回一个包含动漫列表数据的文本内容,通常是JSON格式。
信息
分类
数据库与文件