Anytype MCP Full Control

任何类型的MCP服务器

Anytype的全功能模型上下文协议（MCP）服务器，提供对Anytype功能的完全控制。

特性

• 完成Anytype对象的CRUD操作
• 搜索和筛选对象
• 管理空间、类型和关系
• 使用API密钥进行安全身份验证
• 速率限制和请求验证
• 全面的错误处理
• 日志记录与监视
• Docker支持，易于部署

先决条件

• Node.js 18.0.0或更高版本
• 正在运行的任何类型的桌面应用程序
• 任何类型的API密钥

安装

1. 克隆存储库：

git clone https://github.com/yourusername/anytype-mcp-full-control.git
cd anytype-mcp-full-control

1. 安装依赖项：

npm install

1. 创建一个 .env 根目录中的文件：

NODE_ENV=development
PORT=31009
ANYTYPE_API_URL=http://localhost:31009
ANYTYPE_API_KEY=your_anytype_api_key_here
LOG_LEVEL=info
RATE_LIMIT_WINDOW_MS=900000
RATE_LIMIT_MAX=100

获取您的Anytype API密钥

1. 打开Anytype桌面应用程序
2. 前往“设置”>“高级”
3. 点击“开发者模式”
4. 点击“生成API密钥”
5. 复制API密钥并将其粘贴到 .env 文件

运行服务器

发展模式

npm run dev

生产模式

1. 构建应用程序：

npm run build

1. 启动服务器：

npm start

API文档

服务器运行后，您可以访问API文档，网址为：

http://localhost:31009/api/docs

环境变量

API终点

对象

• GET /api/objects -获取所有对象
• GET /api/objects/:id -按ID获取对象
• POST /api/objects -创建新对象
• PATCH /api/objects/:id -更新对象
• DELETE /api/objects/:id -删除对象
• POST /api/objects/search -搜索对象
• GET /api/objects/:id/relations -获取对象关系

空间

• GET /api/spaces -获取所有空间
• GET /api/spaces/:id -按ID获取空间
• POST /api/spaces -创建新空间
• PATCH /api/spaces/:id -更新空间
• DELETE /api/spaces/:id -删除空格

类型

• GET /api/types -获取所有类型
• GET /api/types/:id -按ID获取类型
• POST /api/types -创建新类型
• PATCH /api/types/:id -更新类型
• DELETE /api/types/:id -删除类型

关系

• GET /api/relations -获取所有关系
• GET /api/relations/:id -通过ID获取关系
• POST /api/relations -创建新关系
• PATCH /api/relations/:id -更新关系
• DELETE /api/relations/:id -删除关系

认证

所有API端点都需要使用API密钥进行身份验证。在中包含API密钥 Authorization 头球

Authorization: Bearer YOUR_API_KEY

或在 X-API-Key 头球

X-API-Key: YOUR_API_KEY

错误处理

API返回标准HTTP状态代码：

• 200 OK -请求成功
• 201 Created -已成功创建资源
• 400 Bad Request -无效请求
• 401 Unauthorized -身份验证失败
• 403 Forbidden -权限不足
• 404 Not Found -未找到资源
• 429 Too Many Requests -超出费率限制
• 500 Internal Server Error -服务器错误

日志记录

日志以不同的日志级别输出到控制台，具体取决于 LOG_LEVEL 环境变量。

测试

要运行测试，请执行以下操作：

npm test

代码检查

要检查代码样式，请执行以下操作：

npm run lint

格式化

要格式化代码，请执行以下操作：

npm run format

部署

码头工人

1. 构建Docker镜像：

docker build -t anytype-mcp .

1. 运行容器：

docker run -d \
  --name anytype-mcp \
  -p 31009:31009 \
  -e NODE_ENV=production \
  -e ANYTYPE_API_KEY=your_api_key_here \
  anytype-mcp

Docker Compose

docker-compose up -d --build

PM2（生产）

1. 全局安装PM2：

npm install -g pm2

1. 启动应用程序：

pm2 start dist/index.js --name "anytype-mcp"

1. 将PM2设置为启动时启动：

pm2 startup
pm2 save

监控

PM2

# List all processes
pm2 list

# View logs
pm2 logs anytype-mcp

# Monitor resources
pm2 monit

# Restart the application
pm2 restart anytype-mcp

# Stop the application
pm2 stop anytype-mcp

# Delete the application
pm2 delete anytype-mcp

贡献

1. 复刻仓库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m "Add some amazing feature")
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

如需支持，请在GitHub存储库上打开一个问题。