@aaplugin/extension-mcp

Optional HTTP MCP declarations and Platform Contributors for aaplugin.

Requires Node.js ^20.19.0 || ^22.13.0 || >=23.5.0.

可选的 MCP HTTP 声明，以及面向各 AAPlugin Platform 的适配实现。

pnpm add -D @aaplugin/kit \
  @aaplugin/platform-claude-code \
  @aaplugin/extension-mcp

import { defineConfig } from '@aaplugin/kit';
import claudeCode from '@aaplugin/platform-claude-code';
import mcp from '@aaplugin/extension-mcp';

export default defineConfig({
  name: 'my-plugin',
  version: '1.0.0',
  description: 'Reusable AI workflows.',
  platforms: [claudeCode()],
  extensions: [mcp()],
});

Remote Streamable HTTP is declarative; provide only the endpoint and runtime secret references:

// src/mcp/docs/mcp.ts
import type { McpServer } from '@aaplugin/extension-mcp';

export default {
  transport: 'http',
  url: 'https://example.com/mcp',
  auth: { type: 'bearer', env: 'DOCS_TOKEN' },
  headers: { 'X-Tenant': { env: 'TENANT_ID' } },
} satisfies McpServer;

HTTP-only MCP validates declarations and target configuration without connecting to a service, reading secret values, compiling code or starting a server. Production endpoints require HTTPS; development also permits loopback HTTP.

自建 stdio、外部 command/args stdio 和 MCP compile 选项均不受支持。旧配置会明确失败；共享 Compiler、Hooks 和 Core Node Runtime 保留。

| Transport | Claude Code | Codex | Cursor | Antigravity | OpenCode | Pi | | --- | --- | --- | --- | --- | --- | --- | | Remote HTTP | Native | Native | Native | Native | Native | Unsupported |

Unsupported transports are reported and never replaced with fabricated client behavior. Contracts were last rechecked on 2026-08-06 against Claude Code MCP, Codex MCP, Cursor MCP, Antigravity Plugins, OpenCode MCP, and Pi Packages.

License

MIT