Skip to content

用于 ADK 的 Atlassian MCP 工具

Supported in ADKPythonTypeScript

Atlassian MCP 服务器 将你的 ADK 智能体连接到 Atlassian 生态系统，弥合了 Jira 中的项目追踪与 Confluence 中的知识管理之间的鸿沟。此集成使你的智能体能够管理问题、搜索并更新文档页面，并使用自然语言简化协作工作流。

使用场景

  • 统一知识搜索：同时搜索 Jira 问题和 Confluence 页面，以查找项目规范、决策记录或历史背景。
  • 自动化问题管理：创建、编辑和转换 Jira 问题状态，或为现有工单添加评论。
  • 文档助手：直接通过你的智能体检索页面内容、生成草稿或在 Confluence 文档中添加内联评论。

先决条件

  • 注册 Atlassian 账户。
  • 拥有包含 Jira 和/或 Confluence 的 Atlassian Cloud 站点。

在智能体中使用

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

root_agent = Agent(
    model="gemini-2.5-pro",
    name="atlassian_agent",
    instruction="帮助用户处理 Atlassian 产品中的数据",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "mcp-remote",
                        "https://mcp.atlassian.com/v1/mcp",
                    ]
                ),
                timeout=30,
            ),
        )
    ],
)

import { LlmAgent, MCPToolset } from "@google/adk";

const rootAgent = new LlmAgent({
    model: "gemini-2.5-pro",
    name: "atlassian_agent",
    instruction: "帮助用户处理 Atlassian 产品中的数据",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: [
                    "-y",
                    "mcp-remote",
                    "https://mcp.atlassian.com/v1/mcp",
                ],
            },
        }),
    ],
});

export { rootAgent };

Note

当你第一次运行此智能体时，浏览器窗口会自动打开以通过 OAuth 请求访问权限。或者，你也可以使用控制台中打印的授权 URL。你必须批准此请求才能允许智能体访问你的 Atlassian 数据。

可用工具

工具 描述
atlassianUserInfo 获取用户信息
getAccessibleAtlassianResources 获取可访问的 Atlassian 资源详情
getJiraIssue 获取 Jira 问题（Issue）信息
editJiraIssue 编辑 Jira 问题
createJiraIssue 创建新的 Jira 问题
getTransitionsForJiraIssue 获取 Jira 问题的工作流转换状态
transitionJiraIssue 执行 Jira 问题的工作流转换
lookupJiraAccountId 查找 Jira 账户 ID
searchJiraIssuesUsingJql 使用 JQL 搜索 Jira 问题
addCommentToJiraIssue 向 Jira 问题添加评论
getJiraIssueRemoteIssueLinks 获取 Jira 问题的远程链接
getVisibleJiraProjects 获取可见的 Jira 项目列表
getJiraProjectIssueTypesMetadata 获取 Jira 项目的问题类型元数据
getJiraIssueTypeMetaWithFields 获取包含字段信息的 Jira 问题类型元数据
getConfluenceSpaces 获取 Confluence 空间信息
getConfluencePage 获取 Confluence 页面内容
getPagesInConfluenceSpace 获取 Confluence 空间中的页面列表
getConfluencePageFooterComments 获取 Confluence 页面的页脚评论
getConfluencePageInlineComments 获取 Confluence 页面的内联（行内）评论
getConfluencePageDescendants 获取 Confluence 页面的子页面
createConfluencePage 创建新的 Confluence 页面
updateConfluencePage 更新现有的 Confluence 页面
createConfluenceFooterComment 在 Confluence 页面中创建页脚评论
createConfluenceInlineComment 在 Confluence 页面中创建内联评论
searchConfluenceUsingCql 使用 CQL 搜索 Confluence
search 通用搜索功能
fetch 获取特定内容

其他资源