使用说明

项目简介

PubDev MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在通过自然语言处理技术简化 Dart 和 Flutter 包在 pub.dev 上的搜索过程。它利用 LLM 理解用户的搜索意图，并提供智能化的包推荐。此外，该服务器还支持执行基本的算术计算。

主要功能点

自然语言包搜索: 用户可以使用日常语言描述所需的功能或包，服务器会利用 LLM 理解查询意图，并在 pub.dev 上进行搜索。
智能包推荐: 基于用户的查询，服务器不仅返回匹配的包，还会根据理解的上下文提供更智能的推荐。
基本算术计算: 支持执行简单的加减乘除运算。

安装步骤

克隆仓库:

git clone [仓库URL，请替换为 https://github.com/kikuchy/pubdev_mcp ]

安装依赖: 进入克隆的仓库目录，运行以下命令安装 Dart 依赖：
```
dart pub get
```

服务器配置

要将 PubDev MCP 服务器添加到 MCP 客户端（例如 Cursor），您需要配置 'mcp.json' 文件。通常该文件位于用户目录下的 '.cursor' 文件夹中。

在 'mcp.json' 文件中，添加以下服务器配置信息：

{
  "mcpServers": {
    "PubDev MCP": {
      "command": "dart [仓库路径]/bin/pubdev_mcp.dart",
      "workingDirectory": "[仓库路径]"
    }
  }
}

配置参数说明:

'"PubDev MCP"': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
'"command"': 服务器启动命令。
- 'dart': 确保您的系统已安装 Dart SDK，并将 'dart' 命令添加到环境变量中。
- '[仓库路径]/bin/pubdev_mcp.dart': 请将 '[仓库路径]' 替换为您克隆 'pubdev_mcp' 仓库的本地绝对路径。 此路径指向服务器的 Dart 启动文件。
'"workingDirectory"': 服务器工作目录。 请将 '[仓库路径]' 替换为您克隆 'pubdev_mcp' 仓库的本地绝对路径。 设置为仓库根目录，确保服务器能正确找到相关资源。

配置示例 (假设仓库克隆到 '/Users/yourname/pubdev_mcp'):

{
  "mcpServers": {
    "PubDev MCP": {
      "command": "dart /Users/yourname/pubdev_mcp/bin/pubdev_mcp.dart",
      "workingDirectory": "/Users/yourname/pubdev_mcp"
    }
  }
}

配置完成后，重启或重新加载您的 MCP 客户端，即可看到并使用 "PubDev MCP" 服务器。

基本使用方法

连接服务器: 在 MCP 客户端中选择或连接到名为 "PubDev MCP" 的服务器。
自然语言搜索: 在 MCP 客户端的交互界面中，使用自然语言输入您想要搜索的 Dart 或 Flutter 包的描述。例如：
- "查找用于网络请求的 Flutter 包"
- "搜索处理 JSON 数据的 Dart 库"
- "推荐一个好用的状态管理 Flutter 包"
算术计算: 输入简单的算术表达式，例如 "1 + 1"，服务器会返回计算结果。

服务器会处理您的请求，利用 LLM 和 pub.dev API 返回相关的包信息或计算结果。请根据您的 MCP 客户端的具体操作方式进行交互。

关键词