Anytype

Interaja com seus dados do Anytype através de sua API, permitindo que assistentes de IA acessem suas informações.

Documentação

O MCP OFICIAL DO ANYTYPE FOI LANÇADO AQUI

Servidor MCP do Anytype

Um servidor MCP (Model Context Protocol) que fornece acesso à API do Anytype, permitindo que assistentes de IA e outros clientes MCP interajam com seus dados do Anytype.

Baseado na definição da API do Anytype v0.46+ (2025-03-17). Garanta que a versão do seu Anytype Desktop seja compatível.

Recursos

Obter lista de espaços (get_spaces)
Buscar/Obter objetos dentro de um espaço (get_objects, search_space) ou globalmente (global_search)
Obter conteúdo detalhado de objetos (get_object_content, suporta recuperação de texto completo)
Criar e excluir espaços (create_space) e objetos (create_object, delete_object)
Exportar objetos como markdown (export_object)
Gerenciar visualizações de lista e objetos dentro de listas (get_list_views, get_list_view_objects, add_objects_to_list, remove_object_from_list)
Obter membros do espaço (get_space_members)
Obter tipos e modelos (get_types, get_type_details, get_templates, get_template_details)

Pré-requisitos

Node.js 18 ou superior
Aplicativo de desktop do Anytype rodando localmente
Uma conta do Anytype

Instalação

Instalação Manual

Clone este repositório:

git clone https://github.com/Qwinty/anytype-mcp.git
cd anytype-mcp

Instale as dependências:
```
npm install
```
Compile o projeto (compila TypeScript para JavaScript em build/):
```
npm run build
```
Obtenha uma Chave de Aplicativo: Antes de configurar o servidor, você precisa de uma Chave de Aplicativo do Anytype. Consulte a seção "Obtendo uma Chave de Aplicativo" abaixo.
Adicione o servidor MCP ao seu arquivo de configuração do MCP

Obtendo uma Chave de Aplicativo

Antes de usar o servidor MCP, você precisa obter uma chave de aplicativo no aplicativo de desktop do Anytype:

Certifique-se de que o desktop do Anytype esteja em execução
Execute o script auxiliar:
```
npm run get-key
```
Siga as instruções para autorizar o aplicativo
Anote a chave de aplicativo para configuração

Configuração

Adicione o servidor MCP do Anytype ao seu arquivo de configuração do MCP:

Para Claude: Edite claude_desktop_config.json
Para outros clientes MCP: Edite os respectivos arquivos de configuração

Exemplo de configuração:

{
  "mcpServers": {
    "anytype": {
      "command": "node",
      "args": ["{path/to/anytype-mcp}/build/index.js"],
      "env": {
        "ANYTYPE_APP_KEY": "YOUR_APP_KEY_HERE"
      },
      "disabled": false
    }
  }
}

Substitua path/to/anytype-mcp pelo caminho real da sua instalação e YOUR_APP_KEY_HERE pela chave de aplicativo obtida.

Uso

Iniciando o servidor

O servidor MCP geralmente é iniciado automaticamente pelo cliente MCP. No entanto, você também pode iniciá-lo manualmente para testes:

npm start

Ferramentas Disponíveis

Consulte Tools.md para uma lista detalhada das ferramentas disponíveis e exemplos de uso.

Prompt do Sistema

Além disso, um exemplo de prompt de sistema para assistentes de IA que usam este servidor está disponível em docs/system-prompt.md.

Eficiência de Tokens e Filtragem de Dados

Para otimizar o uso de tokens com assistentes de IA, este servidor MCP implementa filtragem de respostas por padrão para ferramentas que retornam dados de objetos (get_objects, global_search, search_space).

Comportamento Padrão: O servidor retorna uma versão simplificada dos dados do objeto, incluindo metadados essenciais como ID, nome, tipo, ícone, layout, ID do espaço, ID raiz, trecho (se disponível), contagem de blocos, tags, datas de criação/modificação e informações do criador. O conteúdo completo dos blocos e relações detalhadas são omitidos.
include_text: true: Várias ferramentas (get_objects, get_object_content, global_search, search_space) suportam um parâmetro opcional include_text. Quando definido como true, o servidor extrairá e incluirá o conteúdo de texto completo e formatado dos blocos do objeto em um campo full_text. Use isso quando precisar do texto completo, mas esteja ciente de que aumenta significativamente o tamanho da resposta e a contagem de tokens.
full_response: true: As ferramentas get_objects, global_search e search_space também suportam um parâmetro full_response. Definir isso como true ignora toda a filtragem e retorna a resposta JSON completa e bruta diretamente da API do Anytype. Isso fornece o máximo de detalhes, mas usa mais tokens.

Escolha os parâmetros apropriados com base se você precisa apenas de metadados, conteúdo de texto completo ou a resposta completa da API bruta.

Solução de Problemas

API do Anytype Não Respondendo

Certifique-se de que o aplicativo de desktop do Anytype esteja em execução no seu computador. O servidor MCP se conecta à API local do Anytype em http://localhost:31009/v1.

Problemas de Autenticação

Se você encontrar erros de autenticação:

Execute npm run get-key para obter uma nova chave de aplicativo
Atualize sua configuração do MCP com a nova chave
Reinicie seu cliente MCP

Porta da API Local

O servidor se conecta à API do Anytype em http://localhost:31009/v1 por padrão. Se a sua instalação do Anytype usar uma porta diferente, você precisará modificar a variável apiBaseUrl em src/index.ts e recompilar (npm run build). Tornar isso configurável por meio de uma variável de ambiente é uma possível melhoria futura.

Licença

MIT