Anytype

Interactúa con tus datos de Anytype a través de su API, permitiendo que los asistentes de IA accedan a tu información.

Documentación

EL MCP OFICIAL DE ANYTYPE FUE PUBLICADO AQUÍ

Servidor MCP de Anytype

Un servidor MCP (Model Context Protocol) que proporciona acceso a la API de Anytype, permitiendo que asistentes de IA y otros clientes MCP interactúen con tus datos de Anytype.

Basado en la definición de la API de Anytype v0.46+ (2025-03-17). Asegúrate de que tu versión de Anytype Desktop sea compatible.

Características

Obtener lista de espacios (get_spaces)
Buscar/Obtener objetos dentro de un espacio (get_objects, search_space) o globalmente (global_search)
Obtener contenido detallado de objetos (get_object_content, admite recuperación de texto completo)
Crear y eliminar espacios (create_space) y objetos (create_object, delete_object)
Exportar objetos como markdown (export_object)
Gestionar vistas de lista y objetos dentro de listas (get_list_views, get_list_view_objects, add_objects_to_list, remove_object_from_list)
Obtener miembros del espacio (get_space_members)
Obtener tipos y plantillas (get_types, get_type_details, get_templates, get_template_details)

Requisitos previos

Node.js 18 o superior
Aplicación de escritorio de Anytype ejecutándose localmente
Una cuenta de Anytype

Instalación

Instalación manual

Clona este repositorio:

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

Instala las dependencias:
```
npm install
```
Compila el proyecto (compila TypeScript a JavaScript en build/):
```
npm run build
```
Obtén una clave de aplicación: Antes de configurar el servidor, necesitas una clave de aplicación de Anytype. Consulta la sección "Cómo obtener una clave de aplicación" a continuación.
Añade el servidor MCP a tu archivo de configuración de MCP

Cómo obtener una clave de aplicación

Antes de usar el servidor MCP, necesitas obtener una clave de aplicación desde la aplicación de escritorio de Anytype:

Asegúrate de que Anytype desktop esté ejecutándose
Ejecuta el script auxiliar:
```
npm run get-key
```
Sigue las instrucciones para autorizar la aplicación
Anota la clave de aplicación para la configuración

Configuración

Añade el servidor MCP de Anytype a tu archivo de configuración de MCP:

Para Claude: Edita claude_desktop_config.json
Para otros clientes MCP: Edita sus respectivos archivos de configuración

Ejemplo de configuración:

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

Reemplaza path/to/anytype-mcp con la ruta real de tu instalación y YOUR_APP_KEY_HERE con la clave de aplicación que obtuviste.

Uso

Iniciar el servidor

El servidor MCP generalmente se inicia automáticamente mediante el cliente MCP. Sin embargo, también puedes iniciarlo manualmente para probarlo:

npm start

Herramientas disponibles

Consulta Tools.md para obtener una lista detallada de las herramientas disponibles y ejemplos de uso.

Prompt del sistema

Además, hay un prompt de sistema de ejemplo para asistentes de IA que usan este servidor disponible en docs/system-prompt.md.

Eficiencia de tokens y filtrado de datos

Para optimizar el uso de tokens con asistentes de IA, este servidor MCP implementa filtrado de respuestas por defecto para herramientas que devuelven datos de objetos (get_objects, global_search, search_space).

Comportamiento predeterminado: El servidor devuelve una versión simplificada de los datos del objeto, incluyendo metadatos esenciales como ID, nombre, tipo, icono, diseño, ID del espacio, ID raíz, fragmento (si está disponible), número de bloques, etiquetas, fechas de creación/modificación e información del creador. El contenido completo de los bloques y las relaciones detalladas se omiten.
include_text: true: Varias herramientas (get_objects, get_object_content, global_search, search_space) admiten un parámetro opcional include_text. Cuando se establece en true, el servidor extraerá e incluirá el contenido de texto completo y formateado de los bloques del objeto en un campo full_text. Usa esto cuando necesites el texto completo, pero ten en cuenta que aumenta significativamente el tamaño de la respuesta y el número de tokens.
full_response: true: Las herramientas get_objects, global_search y search_space también admiten un parámetro full_response. Establecer esto en true omite todo el filtrado y devuelve la respuesta JSON completa y sin procesar directamente desde la API de Anytype. Esto proporciona el mayor detalle pero usa la mayor cantidad de tokens.

Elige los parámetros adecuados según necesites solo metadatos, contenido de texto completo o la respuesta completa sin procesar de la API.

Solución de problemas

La API de Anytype no responde

Asegúrate de que la aplicación de escritorio de Anytype esté ejecutándose en tu computadora. El servidor MCP se conecta a la API local de Anytype en http://localhost:31009/v1.

Problemas de autenticación

Si encuentras errores de autenticación:

Ejecuta npm run get-key para obtener una nueva clave de aplicación
Actualiza tu configuración de MCP con la nueva clave
Reinicia tu cliente MCP

Puerto de la API local

El servidor se conecta a la API de Anytype en http://localhost:31009/v1 por defecto. Si tu instalación de Anytype usa un puerto diferente, actualmente necesitas modificar la variable apiBaseUrl en src/index.ts y recompilar (npm run build). Hacer esto configurable mediante una variable de entorno es una posible mejora futura.

Licencia

MIT