Skip to main content
Glama
Tar-ive

Grants Search MCP Server

by Tar-ive

赠款搜索 MCP 服务器

该项目是一个 MCP(模型上下文协议)服务器,提供根据关键字搜索政府补助的工具。

视频介绍

视频介绍

概述

拨款搜索 MCP 服务器使用@modelcontextprotocol/sdk软件包构建。它公开了一个名为“search-grants”的工具,允许用户根据搜索查询来搜索可用的政府拨款。

服务器与 Simpler Grants API 交互以获取授权数据并格式化结果以供显示。

MCP 从Simpler Grants API中检索数据,该 API 提供了一套全面的端点,用于访问政府拨款信息。该 API 目前处于 Alpha 版本,主要用于测试和反馈。它包含搜索机会、检索机构信息以及访问拨款详细数据等功能,所有功能均采用用户友好的格式。

该 API 支持多种筛选条件,用于搜索拨款申请,包括机构、申请人类型、资助类别等。此外,它还提供分页选项,以便高效管理大量结果。

Related MCP server: Startup Concierge Go MCP Server

特征

  • 按关键字搜索政府补助

  • 对搜索结果进行分页

  • 显示每项补助金的详细信息,包括:

    • 机会标题、编号和状态

    • 资助信息(资助下限、资助上限、类别)

    • 日期和截止日期

    • 联系信息

    • 资格要求

    • 附加信息 URL

设置

  1. 克隆存储库并导航到项目目录。

  2. 安装所需的依赖项:

    • Node.js 16 或更高版本

    • npm install

  3. 使用您的 Simpler Grants API 密钥设置API_KEY环境变量。

  4. 启动 MCP 服务器:

    npm start

服务器将开始运行并监听传入的 MCP 客户端连接。

用法

一旦服务器运行,您就可以使用 MCP 客户端(例如 Claude Desktop)连接到它。

要使用“search-grants”工具,只需发送带有以下参数的请求:

  • query :搜索查询(例如,“人工智能”、“气候变化”)

  • page :分页的页码(默认值:1)

  • grantsPerPage :每页显示的授权数量(默认值:3)

服务器将以搜索结果的格式化摘要进行响应,其中包括授权详细信息。

定制

您可以通过修改以下内容来定制服务器:

  • formatGrantDetails :格式化授权信息以供显示的函数

  • createSummary :生成搜索结果摘要的函数

  • API_KEY :用于验证请求的 Simpler Grants API 密钥

故障排除

如果您遇到任何问题,请查看服务器日志以获取更多信息。您也可以联系项目维护人员寻求帮助。

贡献

如果您想为该项目做出贡献,请分叉存储库并提交包含您的更改的拉取请求。

Available Tools

1 tool
search-grantsC

Search for government grants based on keywords

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYesSearch query for grants (e.g., 'Artificial intelligence', 'Climate change')
pageNoPage number for pagination (default: 1)
grantsPerPageNoNumber of grants per page (default: 3)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions searching but doesn't describe behavioral traits such as rate limits, authentication needs, response format, error handling, or whether it's read-only or has side effects. For a search tool with zero annotation coverage, this leaves significant gaps in understanding how it behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's function without unnecessary words. It is appropriately sized and front-loaded, making it easy to understand quickly. Every part of the sentence contributes to clarifying the purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a search tool with no annotations and no output schema, the description is incomplete. It lacks information on behavioral aspects, usage context, and what to expect in return. While the schema covers parameters well, the overall context for effective tool use is insufficient, especially for an agent needing to understand results and limitations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds minimal semantic context beyond the input schema, which has 100% coverage with clear descriptions for all parameters. It implies keyword-based searching but doesn't provide additional details like search scope, result types, or parameter interactions. With high schema coverage, the baseline is 3, as the schema does most of the work.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose as 'Search for government grants based on keywords', which includes a specific verb ('Search'), resource ('government grants'), and mechanism ('based on keywords'). It distinguishes the tool's function well, though without sibling tools, differentiation isn't applicable. The purpose is specific and actionable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, prerequisites, or limitations. It simply states what the tool does without context about appropriate scenarios or constraints. Since there are no sibling tools, this is less critical, but general usage context is still missing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool update
    • First observedsearch-grants

TDQS

B3.1/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'search-grants' has a clear, distinct purpose that cannot be confused with any other tool in the set.

Naming Consistency5/5

The single tool name 'search-grants' follows a consistent verb-noun pattern, and with only one tool, there is no inconsistency or deviation to evaluate. The naming is straightforward and predictable.

Tool Count2/5

A single tool for a grants search server feels thin and under-scoped. While search is a core function, typical grant-related workflows might include operations like filtering, sorting, or retrieving details, making one tool insufficient for comprehensive coverage.

Completeness2/5

The tool set is severely incomplete for a grants search domain. It only provides a basic search function, with obvious gaps such as no ability to view grant details, filter by criteria, or manage saved searches, which are essential for effective agent interaction.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers