iNaturalist MCP服务器
一个MCP服务器,让人工智能助手访问iNaturalist的生物多样性数据——搜索观察结果、探索物种和发现世界任何地方的野生动物。
 
快速开始
添加到MCP配置中:
{
"mcpServers": {
"inaturalist": {
"command": "uvx",
"args": ["inaturalist-mcp"]
}
}
}\[!注意\] 不需要API密钥。此服务器使用公共iNaturalist API。
\[!重要\] 速率限制为每分钟60次请求,以遵守iNaturalist的API指南。
可用工具
| 工具 | 说明 |
|---|---|
search_observations | 按位置、物种、日期和质量等级搜索观察结果 |
get_species_counts | 按观察次数对某一地点观察到的物种进行排名 |
search_taxa | 按通用名或学名搜索物种 |
get_taxon | 获取物种的详细信息(分类、保护状态、照片) |
search_places | 按名称查找iNaturalist地点 |
get_nearby_places | 查找GPS坐标附近的位置 |
search_projects | 查找社区科学项目(生物闪电战、调查) |
get_similar_species | 找出与目标物种经常混淆的物种 |
inaturalist_search | 一次搜索所有iNaturalist资源 |
Full tool reference
搜索观察
按位置、物种、日期等搜索iNaturalist观察结果。
lat(float):基于位置搜索的纬度lng(float):基于位置搜索的经度radius(int):搜索半径,单位为公里(默认值:10,与lat/lng一起使用)place_name(string):要搜索的地名(例如“澳大利亚”、“黄石”)place_id(int):要在其中搜索的自然地点IDtaxon_name(string):要筛选的物种通用名或学名taxon_id(int):i要过滤的自然分类群IDd1(字符串):开始日期(YYYY-MM-DD)d2(字符串):结束日期(YYYY-MM-DD)quality_grade(字符串):research,needs_id,或casualiconic_taxa(string):按组筛选:鸟类、哺乳动物、爬行动物、两栖动物、昆虫、植物、真菌等。page(int):页码(默认值:1)per_page(int):每页结果数(默认值:20,最大值:200)
get_species_counts
按观察次数对某一地点观察到的物种进行排名。非常适合回答“我在这里会看到什么野生动物?”
lat(float):基于位置搜索的纬度lng(float):基于位置搜索的经度radius(int):搜索半径,单位为公里(默认值:10,与lat/lng一起使用)place_name(string):地名(例如“克鲁格国家公园”)place_id(int):i自然地点IDtaxon_name(string):按名称筛选到分类群组(例如“鸟类”)taxon_id(int):按ID筛选到分类群d1(字符串):开始日期(YYYY-MM-DD)d2(字符串):结束日期(YYYY-MM-DD)quality_grade(字符串):research,needs_id,或casualiconic_taxa(string):按组筛选:鸟类、哺乳动物、爬行动物、两栖动物、昆虫、植物、真菌等。per_page(int):要返回的物种数(默认值:20,最大值:200)
search_taxa
按通用名或学名搜索物种或分类群。
q(字符串,必填):搜索查询(例如“鸭嘴兽”、“鸟兽”)is_active(bool):仅显示当前接受的分类群rank(string):按分类等级过滤(种、属、科、目、纲、门、王国)per_page(int):结果数(默认值:10,最大值:30)
get_taxon
按ID获取特定分类群的详细信息。返回分类链、保护状态、维基百科摘要和照片。
taxon_id(int,必填):iNaturalist分类群ID
搜索位置
按名称搜索iNaturalist地点。返回您可以在其他工具中使用的地点ID。
q(字符串,必填):要搜索的地名(例如“黄石”、“哥斯达黎加”)per_page(int):结果数(默认值:10)
get_nearby_places
在一组坐标附近查找iNaturalist位置。返回标准(行政)和社区场所。
lat(浮点数,必填):纬度lng(浮点数,必填):经度
搜索_项目
搜索iNaturalist社区项目(生物闪电战、调查、区域生物多样性项目)。
q(string):搜索查询(例如“鸟悉尼”、“蝴蝶”)lat(浮动):查找附近项目的纬度lng(浮动):查找附近项目的经度place_id(int):iNaturalist地点ID用于过滤per_page(int):结果数(默认值:10)
get_similar_species
将物种与给定的分类群混淆。可用于野生动物识别。
taxon_id(int,必填):iNaturalist分类群ID,用于查找相似物种place_id(int):区域相关结果的可选地点ID
INAURAlist_search
一次搜索所有iNaturalist——分类群、地点、项目和用户。
q(string,必填):搜索查询(例如“帝王蝶迁徙”)sources(字符串):逗号分隔的类型:“taxa”、“places”、“projects”和“users”(默认值:all)per_page(int):结果数(默认值:10)
发展
git clone https://github.com/cvsouth/inaturalist-mcp.git
cd inaturalist-mcp
uv sync --dev
pytest许可证
麻省理工学院
