星战科技xingzhan.cloud
返回市场
艾提奥-MCP服务器

艾提奥-MCP服务器

作者：itsbrex7 星标更新：2025-06-12
安装使用来源：spider==github.com

项目介绍

Attio MCP Server

一款高性能的模型上下文协议（MCP）服务器，提供无缝访问Attio API的功能，使像Claude和Cursor这样的AI助手能够通过人类可读的工具与您的Attio工作区进行交互。

功能

  • 🏷️ 人类可读的工具名称：自动将技术API名称（如getv2objects）转换为清晰、分类的名称（如list_objects）
  • 📊 完整API覆盖：访问对象、记录、属性、列表、任务、笔记等
  • 📁 按类别组织：工具按逻辑类别分组，便于导航
  • 🤖 适用于AI助手：与Claude Desktop和Cursor无缝协作
  • ⚡ 高性能：使用Bun构建，支持快速执行和原生TypeScript
  • 🔧 简单安装：带有智能配置检测的自动化设置脚本

https://github.com/user-attachments/assets/c3a5fe4c-e97e-4bcb-8140-a88c712a35cd

快速开始

  1. 前提条件：

    # 安装Bun（如果尚未安装）
curl -fsSL https://bun.sh/install | bash

  2. 安装和配置：

    ./install.sh

  3. 在.env中添加您的Attio访问令牌：

    ATTIO_ACCESS_TOKEN=your_token_here

    获取您的令牌：https://app.attio.com/settings/api

  4. 重启Claude Desktop或Cursor

手动安装

对于Claude Desktop

./install-claude.sh

这将自动：

  • 将服务器添加到Claude的配置中
  • 使用您的访问令牌配置身份验证
  • 创建现有配置的备份

对于Cursor

./install-cursor.sh

这将自动：

  • 将服务器添加到Cursor的设置中
  • 使用您的访问令牌配置身份验证
  • 创建现有设置的备份

可用工具

MCP服务器将所有Attio API端点作为具有人类可读名称的工具暴露出来，并按类别组织：

核心数据管理

  • 对象：list_objects，create_object，get_object，update_object
  • 记录：list_records，create_record，query_records，delete_record
  • 属性：list_attributes，create_attribute，update_attribute_status

列表及条目

  • 列表：list_lists，create_list，update_list
  • 列表条目：create_list_entry，query_list_entries，update_list_entry

协作

  • 任务：list_tasks，create_task，update_task，delete_task
  • 笔记：list_notes，create_note，get_note，delete_note
  • 评论：create_comment，get_comment，list_comment_threads

管理

  • 工作区：list_workspace_members，get_workspace_member
  • Webhooks：list_webhooks，create_webhook，update_webhook
  • 认证：get_current_user

手动测试

要直接测试服务器：

bun start

配置

服务器使用以下环境变量：

  • ATTIO_ACCESS_TOKEN：您的Attio工作区访问令牌（必需）
  • PORT：用于网络传输的端口（默认：3000）
  • LOG_LEVEL：日志级别（默认：info）

故障排除

  1. 服务器未显示在Claude/Cursor中：

    • 安装后重新启动应用程序
    • 检查日志中的任何错误
    • 确保已构建服务器：bun run build

  2. 身份验证错误：

    • 在.env中验证您的访问令牌
    • 确保令牌具有必要的权限

  3. 构建错误：

    • 运行bun install以确保安装了所有依赖项
    • 运行bun run build以编译TypeScript

开发

要修改服务器：

  1. 编辑src/index.ts
  2. 运行bun run build
  3. 使用bun test进行测试
  4. 重启Claude/Cursor以加载更改

开发命令

# 安装依赖项
bun install

# 构建服务器
bun run build

# 运行测试
bun test

# 运行带覆盖率的测试
bun test --coverage

# 格式化和检查代码
bun run check

# 手动测试
bun run test:manual

支持

对于以下问题：

贡献

欢迎贡献！请随时提交拉取请求。对于重大变更，请先打开一个问题来讨论您想要更改的内容。

许可证

该项目是开源的，并根据MIT许可证提供。

<div align="center"> <sub>为AI社区而建 ❤️</sub> </div>