attio-mcp-server

attio-mcp-server

这是一个用于 Attio（AI 原生 CRM）的 MCP 服务。它允许 MCP 客户端（如 Claude）连接到 Attio API。

当前功能

• 公司 API
  • 搜索公司
  • 读取公司详情
  • 读取公司备注
  • 创建公司备注
• 人员 API
  • 搜索人员
  • 读取人员详情
  • 读取人员备注
  • 创建人员备注
• 列表 API
  • 获取所有列表
  • 获取列表详情
  • 获取列表条目
  • 将记录添加到列表
  • 从列表中移除记录
• 任务 API
• 记录 API

使用方法

你需要：

• ATTIO_API_KEY

该密钥应为 bearer token，你可以通过右侧的 API Explorer 获取，也可以配置 OAuth 并通过 Attio API 获取。

Claude Desktop 配置

{
  "mcpServers": {
    "attio": {
      "command": "npx",
      "args": ["attio-mcp-server"],
      "env": {
        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
      }
    }
  }
}

本地开发时，你可以使用 npm link：

# In the attio-mcp directory
npm run build && npm link

# In your Claude Desktop configuration
# Change the command to use the linked version
{
  "mcpServers": {
    "attio": {
      "command": "node",
      "args": ["PATH_TO_YOUR_REPO/dist/index.js"],
      "env": {
        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
      }
    }
  }
}

开发

前置条件

开始之前，请确保已安装以下内容：

• Node.js（推荐 v18 或更高版本）
• npm
• git
• dotenv
• Docker 和 Docker Compose（可选，用于容器化开发）

设置开发环境

按照以下步骤设置开发环境：

1. Fork 此代码库

   • 点击此代码库右上角的“Fork”按钮
   • 这会在你的 Github 账户下创建一份代码库副本

2. 克隆你的 Fork：

   git clone https://github.com/YOUR_USERNAME/attio-mcp.git
   cd attio-mcp
   

3. 添加上游远程仓库

   git remote add upstream https://github.com/kesslerio/attio-mcp.git
   

4. 复制 dotenv 文件

   cp .env.template .env
   

5. 安装依赖：

   npm install
   

6. 运行 watch，以持续更新 index.js：

   npm run build:watch
   

7. 启动模型上下文协议开发服务：

   dotenv npx @modelcontextprotocol/inspector node ./dist/index.js
   

8. 如果开发服务未能正确加载环境变量，请在 MCP Inspector 左侧设置 ATTIO_API_KEY。

Docker 支持

你也可以在 Docker 容器中运行 Attio MCP Server，这样可以简化部署，并确保在不同环境中的一致性。

构建 Docker 镜像

# Build using the provided script
./scripts/docker-build.sh

# Or build with custom name and tag
./scripts/docker-build.sh --name my-attio-mcp --tag v1.0.0

使用 Docker Compose 运行

1. 在 .env 文件中设置环境变量：

   ATTIO_API_KEY=your_api_key_here
   

2. 使用 Docker Compose 启动容器：

   docker compose up -d
   

3. 查看日志：

   docker compose logs -f
   

4. 停止容器：

   docker compose down
   

直接使用 Docker 运行

docker run -p 9876:3000 \
  -e ATTIO_API_KEY=your_api_key_here \
  --restart unless-stopped \
  --name attio-mcp-server \
  attio-mcp-server:latest

Claude 的 Docker 配置

若要通过 Claude 使用容器化的 Attio MCP Server：

{
  "mcpServers": {
    "attio": {
      "url": "http://localhost:9876"
    }
  }
}

该服务配置为使用外部端口 9876，以避免与常见服务发生冲突。如有需要，你可以在 docker-compose.yml 文件中更改此端口。

Docker 健康检查

Docker 容器包含一项健康检查，用于监控服务状态。你可以通过以下命令查看健康状态：

docker ps -a