使用说明

项目简介

Anytype MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端，它充当了连接 Anytype 桌面应用和 MCP 客户端（如 AI 助手）的桥梁。通过此服务器，AI 助手可以安全地访问和操作您本地 Anytype 应用中的数据，实现知识库的集成和扩展。

主要功能点

数据访问: 获取 Anytype 中的空间、对象及其内容，支持全局搜索和空间内搜索。
数据管理: 创建和删除空间、对象，方便 AI 助手进行内容组织和管理。
内容导出: 将 Anytype 对象导出为 Markdown 格式，便于在其他应用中使用。
列表管理: 管理列表视图和列表中的对象，实现更精细的数据操作。
类型和模板: 获取 Anytype 中的对象类型和模板信息，支持 AI 助手理解和利用 Anytype 的数据结构。
成员管理: 获取空间成员信息，了解协作情况。
数据过滤和优化: 支持响应数据过滤，优化 Token 使用效率，并可根据需求获取完整或精简的对象信息。

安装步骤

克隆仓库:

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

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```
获取 App Key: 运行以下命令并按照提示在 Anytype 桌面应用中完成授权，获取 App Key。
```
npm run get-key
```

服务器配置

要将 Anytype MCP 服务器配置到 MCP 客户端，您需要编辑客户端的配置文件（例如 Claude 的 'claude_desktop_config.json'）。在 'mcpServers' 字段下添加如下配置信息：

{
  "mcpServers": {
    "anytype": {
      "command": "node",
      "args": ["<PATH_TO_ANYTYPE_MCP>/build/index.js"],
      "env": {
        "ANYTYPE_APP_KEY": "<YOUR_APP_KEY_HERE>"
      },
      "disabled": false
    }
  }
}

配置参数说明:

'"anytype"': 服务器名称，可以自定义。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行。
'"args": ["<PATH_TO_ANYTYPE_MCP>/build/index.js"]': 启动参数，指向 'index.js' 文件，请将 '<PATH_TO_ANYTYPE_MCP>' 替换为 Anytype MCP 服务器在您电脑上的实际安装路径。 例如 '/Users/yourname/anytype-mcp/'。
'"env": { "ANYTYPE_APP_KEY": "<YOUR_APP_KEY_HERE>" }': 环境变量配置，请将 '<YOUR_APP_KEY_HERE>' 替换为您在安装步骤中获取的 App Key。
'"disabled": false': 设置为 'false' 启用该服务器。

请注意: MCP 客户端会读取以上配置信息，并自动启动 Anytype MCP 服务器。您无需手动运行 'node index.js' 命令，除非进行测试或调试。

基本使用方法

Anytype MCP 服务器作为 MCP 客户端的后端服务运行，无需用户直接操作。配置完成后，MCP 客户端（如 AI 助手）将能够通过 MCP 协议自动连接到 Anytype MCP 服务器，并利用其提供的工具访问和操作您的 Anytype 数据。

具体的工具调用和使用方法，请参考仓库中的 Tools.md 文件，其中详细列出了每个工具的功能、参数和使用示例。

如果您需要手动测试服务器是否正常运行，可以执行 'npm start' 命令启动服务器。

关键词