项目简介: 这是一个使用TypeScript编写的MCP服务器实现，它将流行的Pixabay图片搜索API封装为一个标准的Model Context Protocol (MCP) 工具，供兼容MCP协议的LLM客户端（如某些桌面版LLM应用）使用。通过集成这个服务器，LLM可以获得搜索和获取高质量图片的能力。

主要功能:

• 提供一个名为 'search_pixabay_images' 的MCP工具。
• 允许LLM客户端通过该工具向Pixabay发送图片搜索请求。
• 支持自定义搜索查询、图片类型（照片、插画、矢量图）、方向（水平、垂直）和每页结果数量。
• 处理Pixabay API响应，并以结构化文本格式返回搜索结果，包括图片链接、标签和作者信息。
• 需要配置有效的Pixabay API Key才能正常工作。
• 包含基本的错误处理机制。

安装步骤:

1. 确保你的系统已安装 Node.js 和 npm。
2. 获取本项目的源代码（例如通过克隆GitHub仓库）。
3. 在项目根目录打开终端，运行 'npm install' 安装所有必要的项目依赖。
4. 运行 'npm run build' 命令编译TypeScript代码，生成可执行的JavaScript文件。
5. 设置 'PIXABAY_API_KEY' 环境变量。将你的Pixabay API Key赋值给这个环境变量。设置方法取决于你的操作系统和shell环境（例如，在Linux/macOS中使用 'export PIXABAY_API_KEY=你的API密钥'，在Windows命令提示符中使用 'set PIXABAY_API_KEY=你的API密钥'）。确保你的LLM客户端启动服务器时能够访问到这个环境变量。

服务器配置（用于MCP客户端）: 要让兼容MCP协议的LLM客户端使用此服务器，你需要在客户端的配置中添加服务器信息。具体的配置位置和格式请参考你的MCP客户端文档。通常，你需要提供以下关键信息：

• 服务器名称 (server name): 一个标识该服务器的唯一名称，例如 'pixabay-mcp'。
• 启动命令 (command): 执行服务器程序的完整路径。通常是项目编译后 'build' 目录下的 'index.js' 文件，例如 '/path/to/your/local/pixabay-mcp/build/index.js'。
• 环境变量 (env): 一个包含服务器运行时所需环境变量的对象。你需要在其中设置 'PIXABAY_API_KEY' 键，其值应为你的Pixabay API密钥。

基本使用方法: 配置并启动该MCP服务器后，你的LLM客户端将在连接时发现 'search_pixabay_images' 工具。当你在与LLM交互时提出需要查找图片的需求（例如“找一些关于太空的图片”），如果LLM判断需要使用工具来完成任务，它可能会自动调用 'search_pixabay_images' 工具，并将你的查询作为参数传递给服务器。服务器执行搜索并将结果返回给LLM，LLM再根据结果生成回复给你。