Skip to main content
Glama
ITIS MCP Server

ITIS MCP Server

by knustx

ITIS MCP 服务器

一个用于通过 SOLR API 与 ITIS(综合分类信息系统)数据库进行交互的模型上下文协议 (MCP) 服务器。

概述

此 MCP 服务器提供对 ITIS 数据库的访问,该数据库包含数十万种物种的分类信息。它使用 ITIS SOLR API 执行搜索并检索分类数据。

Related MCP server: mcp-catalogueoflife

功能

  • 自然语言回答:使用专门的工具和提示词来回答日常问题,例如“北极熊住在哪里?”或“大象的亲戚有哪些?”

  • 按学名搜索:通过学名查找生物

  • 按俗名/通用名搜索:通过通用名查找生物(例如,“人类”、“狗”、“橡树”)

  • 按 TSN 搜索:通过分类序列号 (Taxonomic Serial Number) 查找生物

  • 按界搜索:查找特定界内的生物

  • 按分类等级搜索:搜索特定等级的生物

  • 自动补全搜索:获取部分学名的建议

  • 层级数据:检索完整的分类层级

  • 地理信息:查看物种的分布地

  • 通用 SOLR 搜索:使用自定义 SOLR 查询执行灵活的搜索

  • 随机物种发现:通过灵活的过滤条件从任何分类群中获取随机物种

  • 统计信息:获取数据库统计信息

使用方法

作为 MCP 服务器

该服务器通过 stdin/stdout 进行通信,可与兼容 MCP 的客户端一起使用。

运行服务器:

npm start

开发环境:

npm run dev

自然语言问题

此服务器包含特殊的提示词和工具,可以轻松回答常见的通俗问题:

  • “告诉我关于科莫多巨蜥的信息” -> 使用 species_profile 提示词和 get_full_species_profile 工具

  • “北极熊住在哪里?” -> 使用 where_does_it_live 提示词和 get_geographic_info 工具

  • “大象的亲戚有哪些?” -> 使用 animal_relatives 提示词和 find_relatives 工具

  • “猫科动物里有哪些物种?” -> 使用 whats_in_this_group 提示词和 get_children 工具

  • “狗和狼有什么亲缘关系?” -> 使用 compare_animals 提示词

MCP 客户端配置

构建项目后,将此配置添加到您的 MCP 客户端:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "itis": {
      "command": "npx",
      "args": ["-y", "path/to/itis-mcp"]
    }
  }
}

Cursor/其他 MCP 客户端:

{
  "command": "npx",
  "args": ["-y", "path/to/itis-mcp"]
}

可用工具

1. search_itis

具有灵活参数的通用 SOLR 搜索。

2. search_by_scientific_name

按学名搜索生物。

3. search_by_common_name

按日常通用名(例如,“狗”、“大象”)搜索生物。这通常是普通用户询问动物或植物时想要的结果。

4. search_by_tsn

按分类序列号 (TSN) 搜索。

5. search_by_kingdom

在特定界内搜索。

6. search_by_rank

按分类等级搜索。

7. get_hierarchy

获取 TSN 的分类层级。

8. autocomplete_search

针对部分名称的自动补全搜索。

9. get_random_species

获取带有可选分类过滤器的随机物种。

10. find_relatives

显示特定动物或植物的亲属。接受通用名或学名。

11. get_children

查找包含在较大分类群(例如“猫科”)中的所有物种。

12. get_geographic_info

了解生物的栖息地(地理分区)。接受通用名或学名。

13. get_full_species_profile

一次性获取包含层级、地理位置和同义词的综合资料。

14. explore_taxonomy

通过查找不同分类级别的相关生物来探索分类关系。

15. get_statistics

获取数据库统计信息。

查询示例

以下是一些您可以使用的查询示例:

按学名搜索人类

{
  "tool": "search_by_scientific_name",
  "arguments": {
    "name": "Homo sapiens"
  }
}

按通用名搜索美洲狮

{
  "tool": "search_by_vernacular_name",
  "arguments": {
    "vernacularName": "cougar"
  }
}

搜索植物

{
  "tool": "search_by_kingdom",
  "arguments": {
    "kingdom": "Plantae",
    "rows": 5
  }
}

橡树自动补全

{
  "tool": "autocomplete_search",
  "arguments": {
    "partialName": "Quercus"
  }
}

获取随机鸟类

{
  "tool": "get_random_species",
  "arguments": {
    "kingdom": "Animalia",
    "class": "Aves",
    "count": 3,
    "requireVernacular": true
  }
}

从食肉目中获取随机哺乳动物

{
  "tool": "get_random_species",
  "arguments": {
    "kingdom": "Animalia",
    "class": "Mammalia",
    "order": "Carnivora",
    "count": 2,
    "requireVernacular": true
  }
}

智能生物发现

{
  "prompt": "random_creature_discovery",
  "arguments": {
    "creature_type": "big cats",
    "count": 3
  }
}

发现海鸟

{
  "prompt": "random_creature_discovery",
  "arguments": {
    "creature_type": "sea birds",
    "count": 2,
    "focus_area": "diving birds"
  }
}

获取随机植物

{
  "tool": "get_random_species",
  "arguments": {
    "kingdom": "Plantae",
    "count": 2,
    "requireVernacular": true
  }
}

自定义 SOLR 查询

{
  "tool": "search_itis",
  "arguments": {
    "query": "nameWInd:*tiger* AND kingdom:Animalia",
    "rows": 10,
    "sort": "nameWInd asc"
  }
}

ITIS 数据库字段

ITIS 数据库包含许多字段。以下是最常用的字段:

  • tsn: 分类序列号(唯一标识符)

  • nameWInd: 带指示符的学名

  • kingdom: 界名

  • phylum: 门名

  • class: 纲名

  • order: 目名

  • family: 科名

  • genus: 属名

  • species: 种名

  • author: 作者引用

  • rank: 分类等级

  • usage: 使用状态(有效、无效等)

  • credibilityRating: 数据质量评级

  • phyloSort: 系统发育排序

SOLR 查询示例

ITIS SOLR API 支持多种查询类型:

  • 精确匹配: nameWInd:"Homo sapiens"

  • 通配符: nameWInd:Homo*

  • 范围: tsn:[1 TO 1000]

  • 布尔运算: kingdom:Animalia AND rank:Species

  • 短语: nameWInd:"oak tree"

配置

服务器使用官方 ITIS SOLR 端点: https://services.itis.gov/

由于 ITIS 数据库是公开可访问的,因此不需要 API 密钥。

错误处理

服务器包含全面的错误处理:

  • 网络错误会被捕获并报告

  • 无效查询会返回有用的错误消息

  • 格式错误的响应会被妥善处理

贡献

欢迎提交问题和功能请求!

许可证

MIT 许可证

参考资料

Available Tools

11 tools
explore_taxonomyC

Explore taxonomic relationships by finding related organisms at different taxonomic levels.

Inputs: scientificName (required), level (required), rows.

get_hierarchyC

Get the complete taxonomic hierarchy for a given TSN.

Inputs: tsn (required).

get_random_speciesC

Get random species from ITIS database with optional taxonomic filters.

Inputs: kingdom, phylum, class, order, +5 more.

get_statisticsB

Get basic statistics about the ITIS database (total number of records).

Inputs: no named parameters.

search_by_kingdomB

Search for organisms within a specific kingdom in ITIS database.

Inputs: kingdom (required), rows, start.

search_by_rankB

Search for organisms by their taxonomic rank in ITIS database.

Inputs: rank (required), rows, start.

search_by_scientific_nameC

Search for organisms by their scientific name in ITIS database.

Inputs: name (required), rows, start.

search_by_tsnC

Search for organisms by their Taxonomic Serial Number (TSN) in ITIS database.

Inputs: tsn (required).

search_by_vernacular_nameC

Search for organisms by their common/vernacular names in ITIS database.

Inputs: vernacularName (required), rows, start.

search_itisC

Search ITIS database using SOLR queries. Supports general search with flexible query parameters.

Inputs: query, start, rows, sort, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as autocomplete_search for partial name matching and get_hierarchy for taxonomic relationships. However, search_by_scientific_name and search_itis could be confusing as both handle scientific name queries, though search_itis offers more flexibility with SOLR parameters.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with clear verb_noun structures, such as autocomplete_search and search_by_scientific_name. This uniformity makes the tool set predictable and easy to navigate for an agent.

    Tool Count5/5

    With 11 tools, the server is well-scoped for an ITIS database interface, covering diverse search methods and taxonomic exploration without being overwhelming. Each tool serves a specific function, such as get_random_species for discovery and get_statistics for metadata.

    Completeness4/5

    The tool set provides comprehensive search capabilities across various criteria like name, rank, and TSN, along with taxonomic exploration. A minor gap exists in update or data modification tools, but this is reasonable for a read-focused database server, and agents can still perform most queries effectively.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides a Model Context Protocol server for accessing and querying biomedical data from BioThings services, including gene, variant, chemical, and taxon annotations.
      19
      37
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and retrieving taxonomic information from the Encyclopedia of Life, including taxon pages, scientific names, and hierarchical classifications.
      138 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to resolve scientific names to Taxonomic Serial Numbers, traverse complete taxonomic lineages from kingdom to children, and retrieve vernacular names in all languages from an authoritative US-government taxonomy.
      84 npm
      1
      MIT