Accord Server MCP

协议MCP

MCP（模型上下文协议）客户端 协议 生态系统。此软件包提供了两个不同的MCP客户端：

先决条件

服务器MCP

• Accord服务器运行 MCP_API_KEY 集
• 服务器的基本URL（例如。 http://localhost:39099)

客户端MCP

• 启用开发者模式运行的daccord桌面应用程序
• MCP服务器已在“应用程序设置”>“开发人员”中打开
• 开发人员设置页面中的承载令牌

代理设置

服务器MCP（accordserver）

Accord在以下位置公开了一个可流式传输的HTTP MCP端点 /mcp。以下示例假设您的服务器位于 http://localhost:39099 --替换为实际的URL和API密钥。

克劳德代码

添加一个 .mcp.json 将文件保存到项目根目录（或 ~/.claude/.mcp.json 全局配置）：

{
  "mcpServers": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

或者以交互方式添加：

claude mcp add accord --transport http http://localhost:39099/mcp \
  -H "Authorization: Bearer YOUR_MCP_API_KEY"

食品法典委员会（OpenAI）

创建或编辑 codex.json 在项目根目录中（或 ~/.codex/codex.json 全球）：

{
  "mcpServers": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

开源代码

添加到您的 opencode.json （项目根或 ~/.config/opencode/config.json):

{
  "mcp": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

克劳德桌面版

增添 ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

客户端MCP（daccord桌面应用程序）

启用开发人员模式时，daccord桌面应用程序在端口39101上显示本地MCP服务器。这提供了用户范围的访问以及UI控制、导航和屏幕截图功能。

克劳德代码

{
  "mcpServers": {
    "daccord": {
      "type": "streamable-http",
      "url": "http://localhost:39101/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_DACCORD_MCP_TOKEN"
      }
    }
  }
}

或者以交互方式添加：

claude mcp add daccord --transport http http://localhost:39101/mcp \
  -H "Authorization: Bearer YOUR_DACCORD_MCP_TOKEN"

两者结合使用

AI代理可以同时使用两个MCP服务器——服务器MCP用于管理任务和数据种子，客户端MCP用于导航UI和可视化验证结果：

{
  "mcpServers": {
    "accord": {
      "type": "streamable-http",
      "url": "http://localhost:39099/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    },
    "daccord": {
      "type": "streamable-http",
      "url": "http://localhost:39101/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_DACCORD_MCP_TOKEN"
      }
    }
  }
}

任何兼容MCP的客户端

两个端点都通过流式HTTP使用标准MCP：

• 服务器: http://your-server:39099/mcp + Authorization: Bearer
• 客户: http://localhost:39101/mcp + Authorization: Bearer
• 运输：流式HTTP（POST）
• 协议版本: 2025-03-26

独立CLI客户端

服务器CLI(accord-mcp)

accordserver MCP端点的交互式客户端。

npm install && npm run build
export ACCORD_MCP_API_KEY="your-key"
npm start

客户端CLI(daccord-mcp)

daccord桌面应用程序本地MCP服务器的交互式客户端。

npm install && npm run build
export DACCORD_MCP_TOKEN="your-token"
npm run start:client

从daccord的应用程序设置>开发人员>MCP服务器部分复制令牌。

快速安装

curl -fsSL https://raw.githubusercontent.com/DaccordProject/accordserver-mcp/main/install.sh | bash

服务器CLI示例会话

$ export ACCORD_MCP_API_KEY="your-key"
$ npm start

Connecting to http://localhost:39099/mcp...
Connected. Type 'help' for commands.

accord> info
accord> spaces
accord> channels abc123
accord> messages def456 10
accord> send def456 Hello from the CLI!
accord> exit

客户端CLI示例会话

$ export DACCORD_MCP_TOKEN="dk_a1b2...c3d4"
$ npm run start:client

Connecting to daccord client at http://localhost:39101/mcp...
Connected. Type 'help' for commands.

daccord> state
daccord> spaces
daccord> select-space abc123
daccord> select-channel def456
daccord> screenshot /tmp/audit.png
daccord> viewport compact
daccord> screenshot /tmp/audit_compact.png
daccord> navigate 6.2 with_reply
daccord> screenshot
daccord> exit

服务器CLI命令

客户端CLI命令

可用工具

服务器MCP工具（15）

读取操作

写入操作

节制

客户端MCP工具（35）

工具分为6组。仅 read, navigate，以及 screenshot 默认情况下启用；破坏性团体(message, moderate, voice)需要在daccord的开发人员设置中选择加入。

阅读（8个工具）

导航（12个工具）

屏幕截图（3个工具）

消息（4个工具）

中等（4个工具）

语音（4个工具）

协议细节

两个客户端使用相同的MCP协议：

• 运输：流式HTTP（POST）
• 认证: Authorization: Bearer
• 协议版本: 2025-03-26
• 格式：JSON-RPC 2.0

主要区别

安全须知

服务器MCP

• MCP API密钥授予对服务器的完全管理访问权限
• 将其视为根凭据——不要在客户端代码或日志中公开它
• 除非满足以下条件，否则将完全禁用终结点 MCP_API_KEY 已在服务器上设置
• 通过MCP发送的消息归作者所有 "mcp" 可审计性

客户端MCP

• 需要两个明确的选择加入步骤：开发人员模式+MCP切换
• 令牌按照配置文件加密存储；在UI中隐藏显示
• 监听器绑定到 127.0.0.1 只是——从未接触过网络
• 破坏性工具组（消息、温和、声音）需要明确的选择加入
• 审核工具在执行之前还会检查用户的服务器权限
• 速率限制为每秒60个请求，读取超时5秒
• 令牌可以随时从开发人员设置中旋转

TypeScript库使用

两个客户端都可以作为库导入：

// Server MCP
import { AccordMCPClient } from "accordserver-mcp-client";

const server = new AccordMCPClient({
  url: "http://localhost:39099/mcp",
  apiKey: "your-api-key",
});
await server.connect();
const spaces = await server.listSpaces();

// Client MCP
import { DaccordClientMCPClient } from "accordserver-mcp-client/client-mcp";

const client = new DaccordClientMCPClient({
  url: "http://localhost:39101/mcp",
  token: "dk_a1b2...c3d4",
});
await client.connect();
const state = await client.getCurrentState();
await client.selectSpace("123");
const screenshot = await client.takeScreenshot("/tmp/audit.png");