ITIS MCP Server
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 toolsautocomplete_searchC
Search for organisms with autocomplete functionality using partial names.
Inputs: partialName (required), rows.
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
Scored across 11 tools
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.
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.
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.
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
ITIS (Integrated Taxonomic Information System) MCP.
Search GBIF species taxonomy, occurrence records, datasets, and publishers.
Search GBIF species taxonomy, occurrence records, datasets, and publishers.
O*NET MCP — wraps the O*NET Web Services (US DOL) occupation taxonomy (services.onetcenter.org).…
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides a Model Context Protocol server for accessing and querying biomedical data from BioThings services, including gene, variant, chemical, and taxon annotations.1937MIT
- AlicenseNot gradedqualityBmaintenanceEnables queries about global taxonomic data, including scientific name matching, classification chains, common names, and synonyms from the Catalogue of Life index.94 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables searching and retrieving taxonomic information from the Encyclopedia of Life, including taxon pages, scientific names, and hierarchical classifications.138 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npm1MIT