Grants Search MCP Server 使用说明

项目简介

本项目是一个 MCP 服务器,它通过提供一个名为 'search-grants' 的工具,使用户能够根据关键词搜索美国政府提供的拨款机会。该服务器利用 Simpler Grants API 获取数据,并将结果格式化后返回给 MCP 客户端。

主要功能点

  • 政府拨款搜索: 用户可以通过关键词查询美国政府的各类拨款项目。
  • 分页浏览: 搜索结果支持分页显示,方便用户浏览大量拨款信息。
  • 详细信息展示: 服务器返回的搜索结果包含每个拨款项目的详细信息,如标题、编号、机构、状态、资助金额、申请截止日期、联系方式、申请资格和更多链接等关键信息。

安装步骤

  1. 克隆仓库: 首先,将代码仓库克隆到本地:
    git clone https://github.com/Tar-ive/grants-mcp.git
    cd grants-mcp
  2. 安装依赖: 确保你的机器上安装了 Node.js 16 或更高版本。然后在项目目录下运行以下命令安装项目依赖:
    npm install
  3. 配置API密钥: 你需要从 Simpler Grants API 获取 API 密钥。获取后,将其设置为环境变量 'API_KEY'。例如,在 Linux/macOS 系统中,你可以在终端中使用 'export API_KEY=你的API密钥' 命令设置,或者在 '.env' 文件中设置。
  4. 启动服务器: 完成配置后,在项目目录下运行以下命令启动 MCP 服务器:
    npm start
    服务器成功启动后,会监听 MCP 客户端的连接。

服务器配置

对于 MCP 客户端,你需要配置连接到此 MCP 服务器的必要信息。以下是一个 JSON 格式的配置示例,你需要将其添加到你的 MCP 客户端配置中。

{
  "serverName": "exa",
  "command": "node",
  "args": ["src/index.ts"],
  "transport": "stdio"
}

配置参数说明:

  • 'serverName': MCP 服务器的名称,这里设置为 "exa",与 'src/index.ts' 代码中 'new Server({ name: "exa", ... })' 定义的名称保持一致。
  • 'command': 启动 MCP 服务器的命令,这里使用 'node',假设你的环境中 'node' 命令指向 Node.js 运行时。
  • 'args': 传递给 'command' 的参数,这里指定了服务器入口文件 'src/index.ts'。
  • 'transport': MCP 服务器使用的传输协议,这里设置为 'stdio',表示使用标准输入输出流进行通信。

注意: 请确保你的 MCP 客户端能够正确执行 'node src/index.ts' 命令来启动服务器。根据你的实际环境和 Node.js 安装路径,可能需要调整 'command' 和 'args' 配置。

基本使用方法

  1. 连接服务器: 在 MCP 客户端中配置好上述服务器信息后,启动客户端并连接到 "exa" 服务器。

  2. 调用工具: 连接成功后,你可以使用客户端调用名为 'search-grants' 的工具。

  3. 输入参数: 'search-grants' 工具接受以下参数:

    • 'query' (必填): 搜索关键词,例如 "Artificial intelligence", "Climate change"。
    • 'page' (可选): 页码,用于分页浏览搜索结果,默认为 '1'。
    • 'grantsPerPage' (可选): 每页显示的拨款数量,默认为 '3'。

    例如,你可以发送如下请求来搜索关于 "Artificial intelligence" 的拨款项目:

    {
      "tool_calls": [
        {
          "tool_name": "search-grants",
          "tool_arguments": {
            "query": "Artificial intelligence"
          }
        }
      ]
    }
  4. 查看结果: 服务器会返回包含搜索结果的文本信息,其中会列出符合条件的政府拨款项目的详细信息。

通过以上步骤,你就可以使用 Grants Search MCP Server 提供的政府拨款搜索功能了。

信息

分类

网页与API