Alpaca Trading

Alpaca Trading MCP Server

Um servidor Model Context Protocol (MCP) que fornece uma interface para a API de negociação da Alpaca, permitindo que você gerencie seu portfólio de ações e criptomoedas, faça negociações e acesse dados de mercado.

Recursos

• Gerenciamento de Conta: Visualize detalhes da conta, saldos e status do portfólio
• Negociação: Faça ordens de mercado, limite, stop e stop-limit
• Gerenciamento de Portfólio: Visualize posições, calcule o desempenho e feche posições
• Dados de Mercado: Acesse cotações em tempo real e dados históricos de preços
• Informações de Ativos: Obtenha detalhes sobre ativos negociáveis

Instalação

Instalando via Smithery

Para instalar o Alpaca Trading MCP Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @laukikk/alpaca-mcp --client claude

Instalação Manual

1. Clone este repositório
2. Instale as dependências:

pip install -e .

Ou usando uv:

uv pip install -e .

Configuração

1. Copie o arquivo .env.example para .env:

cp .env.example .env

2. Adicione suas credenciais da API de Paper Trading da Alpaca ao arquivo .env:

ALPACA_PAPER_API_KEY = "your-api-key"
ALPACA_PAPER_API_SECRET = "your-api-secret"

Você pode obter essas credenciais criando uma conta em Alpaca.

Uso

Execute o servidor MCP:

python src/server.py

O servidor será iniciado e ficará disponível para que clientes MCP se conectem.

Testando com Claude for Desktop

Configuração:

Abra a configuração do aplicativo Claude for Desktop em um editor de texto. Crie o arquivo se ele não existir.

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Adicione a configuração do servidor MCP da Alpaca:

{
    "mcpServers": {
        "alpaca": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca-mcp-server",
                "run",
                "src/server.py"
            ]
        }
    }
}

MCP For Server Developers: Quickstart

Recursos Disponíveis

O servidor fornece os seguintes recursos:

• account://info - Obtenha informações atuais da conta
• positions://all - Obtenha todas as posições atuais
• positions://{symbol} - Obtenha detalhes da posição para um símbolo específico
• orders://recent/{limit} - Obtenha as ordens mais recentes com limite especificado
• market://{symbol}/quote - Obtenha a cotação de mercado atual para um símbolo específico
• market://{symbol}/bars/{timeframe} - Obtenha barras de preço históricas para um símbolo com período especificado
• assets://list - Liste ativos negociáveis disponíveis na Alpaca
• assets://{symbol} - Obtenha informações detalhadas do ativo por símbolo

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas:

• get_account_info_tool - Obtenha informações atuais da conta
• place_market_order - Faça uma ordem de mercado para comprar ou vender uma ação
• place_limit_order - Faça uma ordem limitada para comprar ou vender uma ação a um preço especificado
• place_stop_order - Faça uma ordem de stop para comprar ou vender uma ação quando ela atingir um preço especificado
• place_stop_limit_order - Faça uma ordem stop-limit combinando recursos de ordens stop e limit
• cancel_order - Cancele uma ordem aberta pelo seu ID
• close_position - Feche uma posição aberta para um símbolo específico
• get_portfolio_summary - Obtenha um resumo abrangente do portfólio