acuvity/mcp-server-attio

立即开始，您可以使用以下“一键”链接：

https://img.shields.io/badge/VS_Code-%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85-0078d7?logo=githubcopilot](https://insiders.vscode.dev/redirect/mcp/install?name=mcp-server-attio&config=%7B%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22--read-only%22%2C%22-e%22%2C%22ATTIO_API_KEY%22%2C%22docker.io%2Facuvity%2Fmcp-server-attio%3A0.0.2%22%5D%2C%22command%22%3A%22docker%22%7D)

全局范围

按下ctrl + shift + p并输入Preferences: Open User Settings JSON，添加以下部分：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-attio": {
        "env": {
          "ATTIO_API_KEY": "待设置"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "ATTIO_API_KEY",
          "docker.io/acuvity/mcp-server-attio:0.0.2"
        ]
      }
    }
  }
}

工作区范围

在您的工作区创建文件.vscode/mcp.json并添加以下部分：

json
{
  "servers": {
    "acuvity-mcp-server-attio": {
      "env": {
        "ATTIO_API_KEY": "待设置"
      },
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-e",
        "ATTIO_API_KEY",
        "docker.io/acuvity/mcp-server-attio:0.0.2"
      ]
    }
  }
}

要传递密钥，您应使用https://code.visualstudio.com/docs/copilot/chat/mcp-servers%E4%B8%AD%E6%8F%8F%E8%BF%B0%E7%9A%84%60promptString%60%E8%BE%93%E5%85%A5%E7%B1%BB%E5%9E%8B%E3%80%82

在~/.codeium/windsurf/mcp_config.json中添加以下部分：

json
{
  "mcpServers": {
    "acuvity-mcp-server-attio": {
      "env": {
        "ATTIO_API_KEY": "待设置"
      },
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-e",
        "ATTIO_API_KEY",
        "docker.io/acuvity/mcp-server-attio:0.0.2"
      ]
    }
  }
}

更多信息请参考https://docs.windsurf.com/windsurf/mcp%E3%80%82

将以下JSON块添加到您的mcp配置文件：

• 全局范围：~/.cursor/mcp.json
• 项目范围：.cursor/mcp.json

json
{
  "mcpServers": {
    "acuvity-mcp-server-attio": {
      "env": {
        "ATTIO_API_KEY": "待设置"
      },
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-e",
        "ATTIO_API_KEY",
        "docker.io/acuvity/mcp-server-attio:0.0.2"
      ]
    }
  }
}

更多信息请参考https://docs.cursor.com/context/model-context-protocol%E3%80%82

在claude_desktop_config.json配置文件中添加以下部分：

json
{
  "mcpServers": {
    "acuvity-mcp-server-attio": {
      "env": {
        "ATTIO_API_KEY": "待设置"
      },
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-e",
        "ATTIO_API_KEY",
        "docker.io/acuvity/mcp-server-attio:0.0.2"
      ]
    }
  }
}

更多信息请参考https://docs.***.com/en/docs/agents-and-tools/mcp。

本地运行

python
async with MCPServerStdio(
    params={
        "env": {"ATTIO_API_KEY":"待设置"},
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","-e","ATTIO_API_KEY","docker.io/acuvity/mcp-server-attio:0.0.2"]
    }
) as server:
    tools = await server.list_tools()

远程运行

python
async with MCPServerSse(
    params={
        "url": "http://<ip>:<port>/sse",
    }
) as server:
    tools = await server.list_tools()

更多信息请参考https://openai.github.io/openai-agents-python/mcp/%E3%80%82

在您的客户端配置中设置：

• 命令：docker
• 参数：run -i --rm --read-only -e ATTIO_API_KEY docker.io/acuvity/mcp-server-attio:0.0.2

直接运行：

console
docker run -it -p 8000:8000 --rm --read-only -e ATTIO_API_KEY docker.io/acuvity/mcp-server-attio:0.0.2

然后在您的应用/客户端中，可配置为：

json
{
  "mcpServers": {
    "acuvity-mcp-server-attio": {
      "url": "http://localhost:8000/sse"
    }
  }
}

您可能需要为不同工具使用不同端口。

本节假设您熟悉TLS和证书，需要：

• 具有与工具部署匹配的正确DNS/IP字段的服务器证书
• 用于签署客户端证书的client-ca

1. 以backend模式启动服务器：

   • 添加环境变量：-e MINIBRIDGE_MODE=backend
   • 通过卷添加TLS证书（推荐），例如/certs：-v $PWD/certs:/certs
   • 指示Minibridge使用这些证书：
     • -e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem
     • -e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem
     • -e MINIBRIDGE_TLS_SERVER_KEY_PASS=可选
     • -e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pem

2. 本地以frontend模式启动minibridge：

   • 获取适用于您操作系统的https://github.com/acuvity/minibridge%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82

在您的客户端配置中，Minibridge像任何其他STDIO命令一样工作。例如Claude Desktop：

json
{
  "mcpServers": {
    "acuvity-mcp-server-attio": {
      "command": "minibridge",
      "args": ["frontend", "--backend", "wss://<远程URL>:8000/ws", "--tls-client-backend-ca", "/path/to/签署服务器证书的CA/ca.pem", "--tls-client-cert", "/path/to/client-cert.pem", "--tls-client-key", "/path/to/client-key.pem"]
    }
  }
}

就是这样。Minibridge提供了许多额外功能，如需分步指导，请访问wiki，如有不清楚的地方，请随时联系我们！

图表设置要求

此图表需要一些必填信息才能安装。

必填密钥：

• ATTIO_API_KEY 密钥需设置为secrets.ATTIO_API_KEY，可通过.value或现有.valueFrom获取。

如何安装

您可以查看图表README：

console
helm show readme oci://docker.io/acuvity/mcp-server-attio --version 1.0.0

您可以查看可配置的 values：

console
helm show values oci://docker.io/acuvity/mcp-server-attio --version 1.0.0

用Helm安装：

console
helm install mcp-server-attio oci://docker.io/acuvity/mcp-server-attio --version 1.0.0

默认情况下，您的MCP服务器mcp-server-attio可通过集群内的Kubernetes服务mcp-server-attio在端口8000上通过http/sse访问。您可以通过查看values.yaml文件的service部分进行更改。

如何监控

部署将创建一个带有healthPort的Kubernetes服务，用于存活探针和就绪探针。此健康端口也可用于您选择的监控堆栈，并在/metrics路径下暴露指标。

更多关于设置和运行时安全（包括护栏激活）的详细信息，请参考完整图表https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-attio/charts/mcp-server-attio/README.md%E3%80%82