使用说明

🚀 MCP服务器（Jira+Discord）

一个MCP（模型上下文协议）服务器，通过VS Code中的GitHub Copilot与Jira Cloud和Discord集成。

📘 使用 VS Code + GitHub Copilot 的完整配置指南 > 了解如何配置此 MCP 服务器，并将其与 Visual Studio Code 中的 GitHub Copilot 集成。

📑 索引

✨ 功能
🛠️ 可用工具
📋 先决条件
🚀 安装和配置
🔐 MCP 服务器身份验证
💡 使用范例
🐳 码头工人
📁 项目结构
🏗️ SOLID 架构
🔧 解决问题

✨ 功能

🔍 吉拉： 查找问题信息（标题和描述）。
✏️ 吉拉： 更新描述、技术信息和测试计划。
📢 不一致： 通过 Webhook 向频道发送消息。
🤖 原生集成 com GitHub复制品。
🐳 全面支持 ao Docker。

🛠️ 可用工具

Jira 工具

工具	描述	参数
`hello` 连接测试。 `name`
`get_title_description_issue` 查找问题详情。 `key`
`update_infos_issue` 更新技术领域 `key`, `info_tecnicas`, `desc_implementacao`, `plan_testes`
`update_description` 更新描述	`key`, `description`

Discord 工具

工具	描述	参数
`enviar_mensagem_discord` 通过 webhook 发送消息 `mensagem`
`outra_ferramenta` 工具示例。 `param`

📋 先决条件

Visual Studio代码（v1.102+）
Github Copilot已启用
Docker e Docker编写
Conta Atlassian Jira Cloud
Discord Webhook（可选）

🚀 安装和配置

1.API代币do Jira

访问大西洋API代币.
Clique em “创建API令牌”.
代号o令牌（例如：“MCP服务器-VS代码”）。
安全地复制和保存令牌.

2. 使用Docker快速设置

# Clone o repositório
git clone [https://github.com/juliooidella/my-server-mcp.git](https://github.com/juliooidella/my-server-mcp.git)
cd my-server-mcp

# Configure as variáveis de ambiente
cp .env.example .env

编辑文件 .env （请确保使用 MCP_PROD_TOKEN):

# Credenciais do Jira
ATLASSIAN_USERNAME=seu_email@empresa.com
ATLASSIAN_API_TOKEN=seu_token_aqui
JIRA_URL=[https://sua-empresa.atlassian.net/](https://sua-empresa.atlassian.net/)

# Integração Discord (Opcional)
DISCORD_WEBHOOK_URL=[https://discord.com/api/webhooks/](https://discord.com/api/webhooks/)...

# Segurança MCP (OBRIGATÓRIO)
MCP_PROD_TOKEN=seu_token_secreto_aqui_123456

# Configurações do Servidor
SERVER_HOST=0.0.0.0
SERVER_PORT=8015

# Inicie o servidor
docker-compose up --build -d

# Verifique se está a funcionar
curl http://localhost:8015

3. 替代配置（本地Python）

# Usando UV (recomendado)
uv sync
uv run app.py

# Ou usando Python tradicional
python -m venv venv
source venv/bin/activate  # Linux/Mac
pip install -r requirements.txt
python app.py

4. 与VS代码集成

选项A：全局设置

打开到 命令面板 (Ctrl+Shift+P).
数字： MCP：添加服务器.
配置：
- 服务器名称: jira-mcp
- 统一资源定位符: http://localhost:8015
- 范围：全球

选项 B：按工作空间设置（`.vscode/mcp.json`)

{
    "inputs": [
        {
            "type": "promptString",
            "id": "mcp-prod-token", 
            "description": "Insira o Token MCP (definido no .env como MCP_PROD_TOKEN)",
            "password": true
        }
    ],
    "servers": {
        "jira-mcp": {
            "type": "http",
            "url": "http://localhost:8015/mcp",
            "headers": {
                "Authorization": "Bearer ${input:mcp-prod-token}"
            }
        }
    }
}

5. 启动和验证

命令面板 → MCP：列出服务器.
选择 吉拉mcp → 启动服务器.
在Copilot聊天中，单击图标工具 (🔧).
检查 Jira 和 Discord 工具是否出现。

🔐 MCP 服务器身份验证

此项目使用 Token Bearer 身份验证。令牌必须在环境变量中定义 MCP_PROD_TOKEN 在服务器上。客户端（VS代码）必须在标头中发送相同的令牌 Authorization.

💡 使用范例

Jira

Busque os detalhes da issue PROJ-123

Atualize a issue PROJ-456 com:
- Informações técnicas: React 18 + TypeScript
- Implementação: Componentes funcionais com hooks

Discord 的中文翻译是“不和谐”或“纷争”。

Envie uma mensagem no Discord avisando que terminei a tarefa PROJ-123

🐳 码头工人

在后台运行

docker-compose up -d

版本日志

docker-compose logs -f jira-server

📁 项目结构

my-server-mcp/
├── app.py                  # Ponto de entrada
├── src/
│   ├── main.py            # Configuração do FastMCP e registo de ferramentas
│   ├── config/
│   │   └── settings.py    # Validação de variáveis de ambiente
│   ├── services/
│   │   ├── jira_service.py    # Lógica do Jira
│   │   └── discord_service.py # Lógica do Discord
│   └── tools/
│       ├── jira_tools.py      # Definições das ferramentas Jira
│       └── discord_tools.py   # Definições das ferramentas Discord
└── ...

🏗️ SOLID 架构

该项目的结构遵循SOLID原则，在配置，服务和工具（Tools）之间划分责任。查看更多详情改装.md.

🔧 解决问题

错误：“MCP_PROD_TOKEN 不能为空”

请确保您设置了变量 MCP_PROD_TOKEN 在您的文件中 .env 而不是 MCP_AUTH_TOKEN.

服务器未连接

检查 Docker 容器是否正在运行：

docker-compose ps

工具没有出现

命令面板 → MCP：重置缓存工具
命令面板 → MCP：列出服务器 → 重启

专为 Jira + Discord + GitHub Copilot 集成而开发