TypeScript Strands Agent đến MCP

Trình tạo connection có thể kết nối TypeScript Strands Agent của bạn với máy chủ MCP (có thể là TypeScript hoặc Python).

Trình tạo thiết lập tất cả các kết nối cần thiết để agent của bạn có thể khám phá và gọi các công cụ của máy chủ MCP, cả khi được triển khai lên AWS (thông qua Bedrock AgentCore) và khi chạy cục bộ.

Yêu cầu trước

Trước khi sử dụng trình tạo này, hãy đảm bảo bạn có:

1. Một dự án TypeScript với thành phần Strands Agent
2. Một dự án với thành phần máy chủ MCP (có thể là ts#mcp-server hoặc py#mcp-server)
3. Cả hai thành phần được tạo với computeType: BedrockAgentCoreRuntime

Cách sử dụng

Chạy trình tạo

VSCode

1. Install the Nx Console VSCode Plugin if you haven't already
2. Open the Nx Console in VSCode
3. Click Generate (UI) in the "Common Nx Commands" section
4. Search for @aws/nx-plugin - connection
5. Fill in the required parameters
6. Click Generate

CLI

pnpm

pnpm nx g @aws/nx-plugin:connection

yarn

yarn nx g @aws/nx-plugin:connection

npm

npx nx g @aws/nx-plugin:connection

bun

bunx nx g @aws/nx-plugin:connection

You can also perform a dry-run to see what files would be changed

pnpm

pnpm nx g @aws/nx-plugin:connection --dry-run

yarn

yarn nx g @aws/nx-plugin:connection --dry-run

npm

npx nx g @aws/nx-plugin:connection --dry-run

bun

bunx nx g @aws/nx-plugin:connection --dry-run

Chọn dự án agent của bạn làm nguồn và dự án máy chủ MCP của bạn làm đích. Nếu các dự án của bạn chứa nhiều thành phần, hãy chỉ định các tùy chọn sourceComponent và targetComponent để phân biệt.

Tùy chọn

Parameter	Type	Default	Description
sourceProject Required	string	-	The source project
targetProject Required	string	-	The target project to connect to
sourceComponent	string	-	The source component to connect from (component name, path relative to source project root, or generator id). Use '.' to explicitly select the project as the source.
targetComponent	string	-	The target component to connect to (component name, path relative to target project root, or generator id). Use '.' to explicitly select the project as the target.

Kết quả đầu ra của trình tạo

Trình tạo tạo một gói agent-connection được chia sẻ và sửa đổi mã agent của bạn:

• Thư mụcpackages/common/agent-connection

  • Thư mụcsrc

    • Thư mụcapp

      • <mcp-server-name>-client.ts Client cấp cao cho máy chủ MCP được kết nối
    • Thư mụccore

      • agentcore-mcp-client.ts Client MCP AgentCore cấp thấp với xác thực SigV4/JWT
    • index.ts Xuất tất cả các client
  • project.json
  • tsconfig.json

Ngoài ra, nó:

• Chuyển đổi agent.ts của agent để import và sử dụng các công cụ của máy chủ MCP
• Cập nhật target serve-local của agent để phụ thuộc vào target serve của máy chủ MCP
• Cài đặt các phụ thuộc cần thiết

Sử dụng máy chủ MCP đã kết nối

Trình tạo chuyển đổi agent.ts của agent để sử dụng các công cụ của máy chủ MCP:

packages/example/src/my-agent/agent.ts

import { Agent, tool } from '@strands-agents/sdk';
import { MyMcpServerClient } from ':my-scope/agent-connection';

export const getAgent = async (sessionId: string) => {
  const myMcpServerClient = await MyMcpServerClient.create(sessionId);
  return new Agent({
    systemPrompt: '...',
    tools: [myMcpServerClient],
  });
};

Tham số sessionId được truyền từ người gọi, đảm bảo tính nhất quán cho Bedrock AgentCore Observability.

Cơ sở hạ tầng

CDK

Sau khi chạy trình tạo kết nối, bạn cần cấp quyền cho agent để gọi máy chủ MCP:

packages/infra/src/stacks/application-stack.ts

const mcpServer = new MyMcpServer(this, 'MyMcpServer');
const myAgent = new MyAgent(this, 'MyAgent');

// Grant the agent access to bedrock models
myAgent.agentCoreRuntime.addToRolePolicy(
  new PolicyStatement({
    actions: ['bedrock:InvokeModel', 'bedrock:InvokeModelWithResponseStream'],
    resources: ['arn:aws:bedrock:*:*:foundation-model/*', 'arn:aws:bedrock:*:*:inference-profile/*'],
  }),
);

// Grant the agent permissions to invoke the MCP server
mcpServer.agentCoreRuntime.grantInvoke(myAgent.agentCoreRuntime);

ARN runtime AgentCore của máy chủ MCP được tự động đăng ký trong namespace connection của Runtime Configuration bởi CDK construct được tạo, để agent có thể khám phá nó khi chạy.

Terraform

Sau khi chạy trình tạo kết nối, bạn cần cấp quyền cho agent để gọi máy chủ MCP trong cấu hình Terraform của bạn:

packages/infra/src/main.tf

module "inventory_mcp_server" {
  source = "../../common/terraform/src/app/mcp-servers/inventory-mcp"
}

module "story_agent" {
  source = "../../common/terraform/src/app/agents/story-agent"
}

# Grant the agent permissions to invoke the MCP server
resource "aws_iam_policy" "agent_invoke_mcp" {
  name = "AgentInvokeMcpPolicy"
  policy = jsonencode({
    Version = "2012-10-17"
    Statement = [{
      Effect   = "Allow"
      Action   = "bedrock-agentcore:InvokeAgent"
      Resource = module.inventory_mcp_server.agent_core_runtime_arn
    }]
  })
}

resource "aws_iam_role_policy_attachment" "agent_invoke_mcp" {
  role       = module.story_agent.agent_core_runtime_role_arn
  policy_arn = aws_iam_policy.agent_invoke_mcp.arn
}

ARN runtime AgentCore của máy chủ MCP được tự động đăng ký trong namespace connection của Runtime Configuration bởi module Terraform được tạo, để agent có thể khám phá nó khi chạy.

Phát triển cục bộ

Trình tạo cấu hình target serve-local của agent để:

1. Tự động khởi động (các) máy chủ MCP đã kết nối
2. Đặt SERVE_LOCAL=true để client được tạo sử dụng truyền tải HTTP trực tiếp thay vì AgentCore

Chạy agent cục bộ với:

pnpm

pnpm nx <agent-name>-serve-local <project-name>

yarn

yarn nx <agent-name>-serve-local <project-name>

npm

npx nx <agent-name>-serve-local <project-name>

bun

bunx nx <agent-name>-serve-local <project-name>

Điều này sẽ khởi động cả agent và tất cả các máy chủ MCP đã kết nối, với agent kết nối trực tiếp đến các máy chủ MCP qua HTTP trên các cổng cục bộ được chỉ định của chúng.