项目简介

本项目是一个Anytype的Model Context Protocol (MCP) 服务器实现。它充当AI助手与Anytype API之间的桥梁，使得AI助手能够通过标准化的MCP协议来访问和管理Anytype中的数据和功能，例如笔记、任务、空间等。

主要功能点

• Anytype API 集成: 将 Anytype 的 OpenAPI 规范自动转换为AI助手可识别和调用的工具。
• 知识管理: 支持AI助手通过自然语言指令执行 Anytype 中的核心操作，如搜索、创建/管理对象（页面、任务等）、管理空间、属性、标签等。
• MCP 协议支持: 实现 MCP 的核心功能，处理工具列表请求和工具调用请求。
• 身份认证: 支持通过 Anytype API 密钥进行安全的身份验证。

安装步骤

该项目通常通过 npm 或 npx 使用。

1. 获取 Anytype API 密钥:

   • 在 Anytype 桌面应用中打开设置 > API Keys。
   • 创建一个新的API密钥并复制。
   • 或者，您可以使用命令行工具获取密钥（需要 Node.js 环境）： 运行命令 'npx -y @anyproto/anytype-mcp get-key' 并按照提示操作。

2. 安装项目 (可选): 对于频繁使用，您可以选择全局安装： 运行命令 'npm install -g @anyproto/anytype-mcp'

服务器配置 (针对 MCP 客户端)

Anytype MCP Server 作为后台进程运行，供 MCP 客户端连接。您需要在您的 MCP 客户端应用程序中配置如何启动和连接这个服务器。

配置信息通常包括服务器的名称、启动命令及其参数，以及必要的环境变量（特别是API密钥）。

• command: 指定用于启动 Anytype MCP 服务器的可执行命令。如果使用 'npx' 运行，命令就是 'npx'。如果全局安装后运行，命令通常是 'anytype-mcp'。
• args: 指定传递给启动命令的参数。使用 'npx' 时，参数通常是 '-y @anyproto/anytype-mcp'。如果直接运行可执行文件，此项可能为空或包含特定参数。
• env: 一个包含环境变量的 JSON 对象。最重要的环境变量是 'OPENAPI_MCP_HEADERS'，其值是一个 JSON 字符串，包含向 Anytype API 发送请求时所需的HTTP头部。例如，您需要设置 'Authorization' 头部为 'Bearer <您的API密钥>'，并根据 Anytype API 要求设置 'Anytype-Version' 头部。请将 '<您的API密钥>' 替换为您实际获取的密钥。

基本使用方法

配置完成后，支持 MCP 的AI助手将能够识别并使用 Anytype MCP Server 提供的工具。您可以直接通过与AI助手对话的方式，用自然语言指挥其在 Anytype 中执行任务，例如：

• "在我的 Anytype 中创建一个标题为 '项目会议纪要' 的新页面"
• "查找我最近关于 'AI趋势' 的笔记"
• "在 '待办事项' 列表中添加一个任务，叫做 '联系客户 Alice'"
• "列出我在 '项目计划' 空间中的所有任务"

AI助手将解析您的指令，选择合适的Anytype工具（通过Anytype MCP Server提供），执行API调用，并返回结果。