What is Mcps

MCPS is a centralized repository designed to store all the repositories being created, specifically focusing on tools for Model, Control, Process (MCP) that facilitate integration with various APIs and systems.

Use cases

Use cases for MCPS include automating data retrieval and manipulation from Notion databases, managing team tasks and projects, and creating integrations that enhance productivity through streamlined API interactions.

How to use

To use MCPS, clone the repository with its submodules, set up a virtual environment, install dependencies, and configure your API key in a .env file. Follow the installation instructions provided in the README.

Key features

Key features of MCPS include a unified interface for integrating with external services, dedicated submodules for specific APIs (like Notion), advanced querying capabilities, content management, and task management functionalities.

Where to use

MCPS can be used in software development environments where integration with different APIs is required, particularly for applications that need to manage and manipulate data from services like Notion.

MCP - Model, Control, Process

Repositório centralizador para ferramentas MCP (Model, Control, Process) que facilitam a integração com diferentes APIs e sistemas.

🌟 Visão Geral

Este repositório contém módulos MCP que simplificam a integração com serviços externos através de uma interface unificada. Cada submódulo é dedicado a uma API específica e oferece funcionalidades para interagir com o serviço correspondente.

📦 Submódulos

Notion MCP

O submódulo Notion MCP fornece um conjunto de ferramentas para interagir com a API do Notion, permitindo:

• Consultar bancos de dados do Notion com filtros avançados e ordenação
• Recuperar e manipular páginas e blocos de conteúdo
• Gerenciar tarefas com suporte a proprietários e membros da equipe
• Criar novas páginas e atualizar propriedades e conteúdo
• Realizar pesquisas avançadas no workspace do Notion
• Extrair e formatar conteúdo de páginas para melhor legibilidade

📋 Requisitos

• Python 3.13+
• uv - Gerenciador de pacotes e ambientes Python
• Chave de API do Notion

🚀 Instalação

1. Clone o repositório com submódulos

git clone --recursive https://github.com/seu-usuario/mcp.git
cd mcp

Se você já clonou o repositório sem a flag --recursive, inicialize e atualize os submódulos:

git submodule init
git submodule update

2. Configure o ambiente e instale dependências

# Cria um ambiente virtual
uv venv

# Ativa o ambiente virtual
# No Windows:
.venv\Scripts\activate
# No macOS/Linux:
source .venv/bin/activate

# Instala as dependências
uv pip install -r requirements.txt

3. Configure a chave de API

Crie um arquivo .env na raiz do projeto com sua chave de API:

NOTION_API_KEY=seu_token_da_api_notion

Para obter sua chave de API do Notion:

1. Acesse https://www.notion.so/my-integrations
2. Crie uma nova integração
3. Copie o token secreto
4. Compartilhe seu banco de dados ou página com a integração

🔧 Uso

Para utilizar o submódulo Notion MCP:

# Inicie o servidor MCP
cd notion
uv run mcp install main.py -f .env

🧩 Estrutura do Projeto

mcp/
├── .gitmodules              # Configuração dos submódulos Git
├── notion/                  # Submódulo Notion MCP
│   ├── main.py              # Funções de integração com a API do Notion
│   ├── pyproject.toml       # Configuração do projeto Python
│   └── README.md            # Documentação específica do Notion MCP
├── .env                     # Variáveis de ambiente (não versionado)
└── README.md                # Este arquivo

📄 Licença

Este projeto está licenciado sob a MIT License.

Desenvolvido por Valdeir Sapará