Paytm MCP Server

Um servidor para gerenciar links de pagamento e transações do Paytm.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Paytm

Um servidor MCP (Painel de Controle do Comerciante) baseado em Python para gerenciar links de pagamento e transações do Paytm.

Recursos

  • Crie links de pagamento do Paytm para clientes
  • Busque todos os links de pagamento criados
  • Recupere transações de um link de pagamento específico

Pré-requisitos

  • Python 3.12 ou superior
  • Credenciais de comerciante Paytm:
    • PAYTM_MID
    • PAYTM_KEY_SECRET
  • As seguintes dependências Python:
    • httpx>=0.28.1
    • mcp[cli]>=1.7.0
    • paytmchecksum
    • pycryptodome
    • requests
  • uv (um instalador e executor rápido de pacotes Python)
  • Claude Desktop (para executar e gerenciar o servidor)

Instalação

Opção 1: Configuração Automatizada (Recomendada)

Use o script setup.sh fornecido para instalação e configuração automatizadas:

# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh

O script irá:

  1. Verificar dependências necessárias (Python 3.12+, uv, Claude Desktop)
  2. Clonar ou atualizar o repositório
  3. Criar e ativar um ambiente virtual
  4. Instalar todas as dependências necessárias
  5. Criar um modelo de arquivo .env para as credenciais do Paytm

Opção 2: Instalação Manual

  1. Clone o repositório:

    git clone git@bitbucket.org:paytmteam/payment-mcp.git
cd payment-mcp

  2. Crie e ative um ambiente virtual:

    uv venv
source .venv/bin/activate

  3. Instale as dependências:

    uv pip install .

Configuração

  1. Crie um arquivo .env na raiz do projeto:

    # Paytm credentials
PAYTM_MID=your_paytm_mid
PAYTM_KEY_SECRET=your_paytm_key_secret

  2. Atualize o arquivo .env com suas credenciais reais do Paytm

Executando o Servidor MCP com Claude Desktop

O servidor foi projetado para ser gerenciado e executado via Claude Desktop. Você não precisa executar o servidor manualmente pela linha de comando.

Exemplo de claude_desktop_config.json

Coloque este arquivo na raiz do seu projeto ou conforme exigido pelo Claude Desktop:

{
  "mcpServers": {
    "paytm-mcp-server": {
      "command": "uv path",
      "args": ["--directory", "path to project", "run", "paytm_mcp.py"],
      "env": {
        "PAYTM_MID": "****************",
        "PAYTM_KEY_SECRET": "************"
      }
    }
  }
}
  • Atualize os caminhos command e args conforme necessário para o seu ambiente.
  • A seção env deve conter suas credenciais reais do Paytm.

Próximos Passos

  1. Atualize o claude_desktop_config.json com suas credenciais do Paytm
  2. Reinicie o servidor usando o Claude Desktop

Estrutura do Projeto

  • paytm_mcp.py: Ponto de entrada principal do servidor e definições de ferramentas
  • services/: Lógica de negócios para pagamentos
  • config/: Configuração e definições
  • utils/: Modelos de dados e utilitários

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

A Licença MIT é uma licença permissiva que permite que você:

  • Use o código comercialmente
  • Modifique o código
  • Distribua o código
  • Use o código de forma privada
  • Sublicencie o código

O único requisito é que o aviso de licença e direitos autorais deve ser incluído em todas as cópias ou partes substanciais do software.