使用说明
Atlassian MCP服务器
一个模型上下文协议(MCP)服务器,提供与Atlassian Jira和Confluence的全面集成。此服务器允许LLM与您的Atlassian套件交互,以搜索、查看和修改问题和页面。
特性
Jira工具
- 搜索:使用JQL查找问题(
searchJiraIssuesUsingJql). - 问题管理:
- 获取问题详细信息(
getJiraIssue). - 创建(
createJiraIssue)并编辑(editJiraIssue)问题。 - 查看远程链接(
getJiraIssueRemoteIssueLinks).
- 获取问题详细信息(
- 评论和工作日志:添加评论(
addCommentToJiraIssue)以及工作日志(addWorklogToJiraIssue). - 元数据:检查问题类型(
getJiraProjectIssueTypesMetadata,getJiraIssueTypeMetaWithFields). - 过渡:查看(
getTransitionsForJiraIssue)并执行(transitionJiraIssue)工作流转换。 - 项目和用户:列出可见项目(
getVisibleJiraProjects)并查找帐户ID(lookupJiraAccountId).
汇流工具
- 搜索:使用CQL查找页面(
searchConfluenceUsingCql). - 页面管理:
- 获取页面内容(
getConfluencePage). - 创建(
createConfluencePage)并更新(updateConfluencePage)页面。 - 列出后代(
getConfluencePageDescendants)空间中的页面(getPagesInConfluenceSpace).
- 获取页面内容(
- 评论:
- 添加页脚(
createConfluenceFooterComment)和内联(createConfluenceInlineComment)评论。 - 阅读评论(
getConfluencePageFooterComments,getConfluencePageInlineComments).
- 添加页脚(
- 空间:列出可用空间(
getConfluenceSpaces).
先决条件
- Python 3.10或更高版本
- Atlassian帐户(Jira/Confluence Cloud)
- 大西洋API代币
安装
-
克隆存储库:
git clone <repository_url> cd Atlassian-MCP-Server -
创建并激活虚拟环境:
python3 -m venv .venv source .venv/bin/activate # On Windows use .venv\Scripts\activate -
安装依赖项:
pip install -r requirements.txt
配置
-
创建一个
.env根目录中的文件:touch .env -
将您的Atlassian凭据添加到
.env:ATLASSIAN_EMAIL=your_email@example.com ATLASSIAN_API_TOKEN=your_api_token ATLASSIAN_BASE_URL=https://your-domain.atlassian.net备注:您可以从您的 Atlassian帐户设置.
用法
本地运行
要专门运行服务器(尽管通常通过MCP客户端使用):
python server.py
与Claude Desktop一起使用
要将此服务器与Claude Desktop一起使用,请将以下配置添加到您的 claude_desktop_config.json (通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):
{
"mcpServers": {
"atlassian": {
"command": "/path/to/Atlassian-MCP-Server/.venv/bin/python",
"args": [
"/path/to/Atlassian-MCP-Server/server.py"
]
}
}
}
替换 /path/to/Atlassian-MCP-Server 带有克隆存储库的绝对路径。
贡献
欢迎投稿!请随时提交拉取请求。