Prompt Book Server

Conecta-se a bancos de dados do Notion para gerenciar, pesquisar e recuperar prompts de IA em várias coleções.

Documentação

Prompt Book Server

Um servidor MCP que se conecta a bancos de dados do Notion contendo prompts de IA, permitindo que você gerencie, busque e recupere prompts de forma eficiente em várias coleções de prompts.

O que o Prompt Book Server faz?

O Prompt Book Server é uma ferramenta poderosa que ajuda você a organizar e acessar seus prompts de IA armazenados em bancos de dados do Notion. Ele oferece os seguintes recursos principais:

Múltiplos livros de prompts: gerencie várias coleções de prompts (livros de prompts) com diferentes bancos de dados do Notion
Descoberta de prompts: busque, filtre e navegue por prompts por título, tipo ou tags
Recuperação de prompts: acesse rapidamente o conteúdo completo de qualquer prompt
Gerenciamento de prompts: adicione novos prompts, atualize os existentes e copie prompts entre livros
Criação de bancos de dados: crie novos bancos de dados de prompts com o esquema adequado diretamente no Notion

O servidor atua como uma ponte entre suas ferramentas de IA e suas coleções de prompts baseadas no Notion, facilitando a manutenção de uma biblioteca centralizada de prompts que pode ser acessada por diversas ferramentas de codificação e IA.

Todas as ferramentas

Ferramentas de gerenciamento de configuração

Nome da ferramenta	Descrição
`list_prompt_books`	Lista todos os livros de prompts configurados
`create_prompt_book_config`	Adiciona uma nova configuração de livro de prompts
`remove_prompt_book_config`	Remove uma configuração de livro de prompts
`activate_prompt_book`	Define um livro de prompts como ativo
`rename_prompt_book`	Renomeia uma configuração de livro de prompts
`create_prompt_database`	Cria um novo banco de dados de prompts no Notion e o adiciona à configuração
`copy_prompt`	Copia um prompt de um livro para outro

Ferramentas de gerenciamento de prompts

Nome da ferramenta	Descrição
`list_prompts`	Lista todos os prompts no banco de dados ativo
`search_prompts_by_title`	Busca prompts por título
`get_prompts_by_tag`	Obtém prompts filtrados por uma tag específica
`get_prompts_by_type`	Obtém prompts filtrados por um tipo específico
`read_prompt`	Lê o conteúdo completo de um prompt específico
`list_all_types`	Lista todos os tipos de prompts exclusivos no banco de dados
`list_all_tags`	Lista todas as tags exclusivas usadas no banco de dados
`add_prompt`	Adiciona um novo prompt ao banco de dados
`update_prompt`	Atualiza um prompt existente no banco de dados

Como configurar nas minhas ferramentas de codificação (ou ferramentas não relacionadas a codificação)?

Adicionar à configuração do MCP

Adicione o servidor ao seu arquivo de configuração do MCP. A localização depende do seu cliente MCP:

Caminho para o arquivo de configuração do MCP

cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
roo_code: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
windsurf: ~/.codeium/windsurf/mcp_config.json
claude: ~/Library/Application Support/Claude/claude_desktop_config.json

Adicione a seguinte configuração:

{
  "mcpServers": {
    "prompt-book-server": {
      "command": "npx",
      "args": [
        "-y",
        "@piccollage/prompt-book-mcp-server"
      ],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Exemplos de prompts para trabalhar com ele

Aqui estão alguns exemplos de prompts que você pode usar para interagir com o Prompt Book Server:

Listando e buscando prompts

List all my prompt books.

Show me all prompts in the prompt book.

Search for prompts related to "GPUImage" in my prompt book.

Show me all prompts with the tag "PicCollage".

List all prompts of type "Coding"

What types of prompts are available in my prompt book?

Lendo prompts

Get the prompt about idea evaluation from the prompt book.
Follow the instructions in it and then verify the following idea for me:
describe your idea

Gerenciando livros de prompts

Activate the engineering prompt book.

Copy the GPUImage porting prompt from my private book to the engineering book.

Adicionando e atualizando prompts

Add a new prompt titled "React Component Generator" with type "Coding" and tags ["React", "Frontend"].

The prompt should include ....
......
.....

Update the "React Component Generator" prompt to include TypeScript support.

Please create a very detailed prompt to instruct LLM agents to convert Android XML UI implementations into Compose UI elements or screens. Put that prompt to the prompt book.

Como adicionar um novo livro de prompts?

Você tem duas opções principais para adicionar um novo livro de prompts:

Opção 1: Conectar a um banco de dados existente do Notion

Se você já possui um banco de dados do Notion com prompts, pode conectá-lo diretamente:

Obtenha seu token da API do Notion em https://www.notion.so/my-integrations
Compartilhe seu banco de dados do Notion com sua integração
Obtenha o ID do banco de dados a partir da URL (é a parte após o nome do espaço de trabalho e antes do ponto de interrogação)
Use a ferramenta create_prompt_book_config:

Add a new prompt book with the following details:
- Name: "My Team Prompts"
- Notion token: "secret_abc123..."
- Notion database ID: "1a748be2b63280988d9bc5f89918431d"

Opção 2: Criar um novo banco de dados do Notion

Se quiser criar um novo banco de dados de prompts com o esquema correto:

Obtenha seu token da API do Notion em https://www.notion.so/my-integrations
Encontre o ID de uma página do Notion onde deseja criar o banco de dados
Use a ferramenta create_prompt_database:

Create a new prompt database with these details:
- Name: "My New Prompt Book"
- Notion token: "secret_abc123..."
- Page ID: "1a748be2b63280988d9bc5f89918431d"
- Activate: true

Isso criará um novo banco de dados com o esquema adequado (Nome, Tipo, Tags) e o adicionará à sua configuração.

Requisitos do banco de dados do Notion

Para um funcionamento ideal, seu banco de dados do Notion deve ter as seguintes propriedades:

Nome (título): o título do prompt
Tipo (seleção): a categoria do prompt (ex.: "Codificação", "Geração de Imagens")
Tags (seleção múltipla): tags para organizar e filtrar prompts

O conteúdo do prompt em si é armazenado no corpo da página como blocos de texto.

Desenvolvimento

Pré-requisitos

Node.js 16+
TypeScript
Token da API do Notion

Configuração

Clone o repositório
Instale as dependências: npm install
Compile o projeto: npm run build
Execute o servidor: npm start

Estrutura do arquivo de configuração

O arquivo de configuração em ~/.mcp_config/prompt_book.json tem a seguinte estrutura:

{
  "promptBooks": [
    {
      "id": "uuid-string",
      "name": "My Prompt Book",
      "notion_token": "your-notion-api-token",
      "notion_database_id": "your-notion-database-id"
    }
  ],
  "activePromptBookId": "uuid-string"
}

Configuração por variável de ambiente (DEFAULT_BOOKS)

Você pode fornecer uma configuração padrão usando a variável de ambiente DEFAULT_BOOKS. Isso é particularmente útil para:

Configurar automaticamente livros de prompts em ambientes de implantação
Fornecer configurações padrão para membros da equipe
Pré-popular o servidor com configurações de livros de prompts

A variável de ambiente DEFAULT_BOOKS deve conter uma string JSON válida que corresponda à estrutura do arquivo de configuração acima.

Notas importantes:

A variável de ambiente DEFAULT_BOOKS só é usada quando o arquivo de configuração ~/.mcp_config/prompt_book.json ainda não existe
Se o arquivo de configuração já existir, a variável de ambiente é ignorada
Se o JSON em DEFAULT_BOOKS for inválido ou não corresponder à estrutura esperada, ele será ignorado e uma configuração vazia será criada em seu lugar

Exemplo de uso:

# Set the environment variable
export DEFAULT_BOOKS='{"promptBooks":[{"id":"12345678-1234-1234-1234-123456789012","name":"Default Prompt Book","notion_token":"secret_abc123...","notion_database_id":"1a748be2b63280988d9bc5f89918431d"}],"activePromptBookId":"12345678-1234-1234-1234-123456789012"}'

# Run the server - it will use the DEFAULT_BOOKS configuration if no config file exists
npx @piccollage/prompt-book-mcp-server

Esse recurso é especialmente útil ao implantar o servidor em ambientes conteinerizados ou quando você deseja fornecer uma configuração pré-configurada para membros da equipe.