eBird MCP Server

Consulte dados ricos de observação de aves da API eBird usando linguagem natural.

Documentação

Servidor MCP do eBird

Combine o eBird com IA: Crie seu Assistente Pessoal de Observação de Aves

Este projeto integra a API do eBird a um Servidor MCP (Model Context Protocol), permitindo que você consulte dados de observação de aves por meio de linguagem natural diretamente na janela de chat do Claude.

Começando

Pré-requisitos

Chave da API do eBird: Crie uma conta no eBird e solicite uma chave de API.
Aplicativo Claude Desktop: Baixe e instale o aplicativo Claude Desktop.
Instale o Python (veja este tutorial).

Instalação

Clone o repositório

 git clone git@github.com:siansiansu/ebird-mcp-server.git
 cd ebird-mcp-server

Instale as dependências

pip install -r requirements.txt

Configuração

Configure o Claude Desktop

Abra o Claude Desktop.
Navegue até Configurações > Desenvolvedor > Editar Configuração > Editar arquivo claude_desktop_config.json.
Substitua a configuração pelos seus caminhos e chave de API:

{
  "mcpServers": {
    "ebird-api": {
      "command": "/absolute/path/to/python",
      "args": [
        "/absolute/path/to/ebird-mcp-server/server.py"
      ],
      "env": {
        "EBIRD_API_KEY": "your-ebird-api-key"
      }
    }
  }
}

Importante:

command: Caminho absoluto para o seu executável Python.
args: Caminho absoluto para server.py.
EBIRD_API_KEY: Sua chave de API do eBird.

Reinicie o Claude

Após salvar a configuração, reinicie o aplicativo Claude Desktop. Ele iniciará e gerenciará automaticamente o servidor MCP.

Uso

Abra um chat no Claude e use qualquer um dos exemplos de prompts (ou crie os seus) para consultar dados do eBird.

Recursos

Aqui estão exemplos de prompts que você pode usar para consultar dados. A IA decidirá quando chamar o Servidor MCP do eBird, ou você pode instruí-la explicitamente a fazê-lo.

Observações

Consultar observações recentes em um local

What birds have been seen recently in Budai, Chiayi?

Consultar observações recentes de uma espécie

Are there any recent records of Black-faced Spoonbill in Tainan?

Consultar observações notáveis (raras)

What rare birds have been reported recently in Hsinchu?

Checklists

Principais colaboradores

List the top 100 eBird contributors in Taipei on June 26, 2025.

Todos os checklists em uma data

Show all checklists submitted in Kaohsiung on June 15, 2024.

Checklists recentes

Provide the latest checklists submitted in Tainan.

Estatísticas resumidas

Summarize all observation checklists in New Taipei on June 20, 2024.

Detalhes do checklist

Show details for checklist ID S12345678.

Hotspots

Listar hotspots em um local

List all eBird hotspots in Tainan.

Hotspots próximos

List birding hotspots within 5 km of my current location.

Taxonomia

Taxonomia oficial

Provide the eBird taxonomy data for Black-faced Spoonbill.

Listar subespécies

List all subspecies of White-breasted Waterhen.

Licença

Este projeto é licenciado sob a Licença MIT.