项目简介

该项目是一个基于Model Context Protocol (MCP) 的服务器实现，专门为AI智能体提供Gleam编程语言生态系统的包管理功能。它允许AI智能体搜索Gleam包、获取详细的包信息以及访问包的在线文档，从而帮助AI智能体更好地理解和使用Gleam语言，提升开发效率。

主要功能点

包搜索: 允许AI智能体根据包名或描述快速搜索Gleam包。
详细信息查询: 提供关于特定Gleam包的详细数据，包括版本、依赖、描述等。
文档访问: 能够构建并提供Gleam包的文档接口，支持文档分页浏览，方便AI智能体获取API使用说明。
自动同步与缓存: 服务器会自动同步最新的Gleam包信息，并对文档进行持久化缓存，以提高响应速度和数据新鲜度。

安装步骤

如果您希望在本地运行此MCP服务器，请遵循以下步骤：

下载项目: 首先，通过 'git clone https://github.com/renatillas/mcp_packages' 命令将项目仓库克隆到您的本地机器，或直接下载仓库代码。
安装依赖: 进入项目目录后，运行 'gleam deps download' 命令安装所需的Gleam语言依赖。
启动服务器: 运行 'gleam run' 命令，MCP服务器将在默认端口（通常是3000）启动，等待客户端连接。

服务器配置

MCP服务器是为MCP客户端（如Claude Code, Cline, Continue, Cursor等AI智能体平台）提供服务的。您的MCP客户端需要配置服务器的连接信息才能与其交互。

推荐方式：使用已部署的在线服务

此MCP服务器已部署并可在公共网络访问。这是最简单、最快捷的集成方式。

{
  "mcpServers": {
    "gleam-mcp": {
      "transport": "http", // 指定与MCP服务器通信的传输协议，这里是HTTP。
      "url": "https://gleam-package-mcp.fly.dev" // MCP服务器的URL地址。
    }
  }
}

此配置指示您的MCP客户端通过HTTP协议连接到指定的在线URL。

本地运行方式：

如果您在本地启动了MCP服务器，可以使用以下配置让MCP客户端连接到本地实例：

{
  "mcpServers": {
    "gleam-mcp": {
      "command": "gleam", // 启动MCP服务器的命令。
      "args": ["run"], // 传递给启动命令的参数。
      "cwd": "/absolute/path/to/mcp_packages" // MCP服务器项目所在的绝对路径。
    }
  }
}

此配置指示您的MCP客户端在指定路径下运行 'gleam run' 命令来启动本地MCP服务器进程，并与之建立连接。

基本使用方法

一旦MCP服务器被您的AI智能体平台成功集成和配置，您的AI智能体就可以通过自然语言与该服务器提供的工具进行交互，从而获取Gleam包的相关信息。以下是一些使用示例：

"Search for Gleam packages related to json" (搜索与JSON处理相关的Gleam包)
"Get information about the wisp package" (获取名为wisp的Gleam包的详细信息)
"Build documentation for the gleam_http package" (构建并获取gleam_http包的文档内容)

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息