Skip to main content
Glama
bcosta19

MCP Gestão de Tarefas

by bcosta19

MCP 任务管理

基于模型上下文协议(MCP)的独立服务器,用于将开发代理集成到任务管理系统中。

要求

  • Node.js 22.5 或更高版本;

  • 能够访问任务管理服务器;

  • 有效的凭据或身份验证令牌。

Related MCP server: Project Manager MCP

安装

npm install
npm run build

配置与身份验证

助手会在本地配置服务器 URL 和身份验证。URL 可以通过 GESTAO_TAREFAS_API_URL 变量、--api-url 参数或在助手运行期间提供。

npm run setup

当 URL 未配置时,助手会提示:

URL do Gestão de Tarefas:

也可以通过参数提供访问数据:

npm run setup -- \
  --api-url=https://seu-servidor-de-gestao.exemplo \
  --email=seu.email@empresa.gov.br \
  --password=suasenha

要使用现有的 Web 会话或令牌:

npm run setup -- --api-url=https://seu-servidor-de-gestao.exemplo --token=SEU_TOKEN

助手会尝试通过 JSON 端点进行身份验证,如果不可用,则使用带有 CSRF 的 Web 表单。凭据不会进行版本控制。会话或令牌会保存在本地的 .env 文件和 ~/.gestao-tarefas-mcp/config.json 中。

现有的 Web 会话或令牌可以提供给助手,或在 GESTAO_TAREFAS_API_TOKEN 中配置。

环境变量

.env.example 文件包含参考配置:

GESTAO_TAREFAS_API_URL=https://seu-servidor-de-gestao.exemplo
GESTAO_TAREFAS_API_TOKEN=cole_a_sessao_web_ou_token_aqui
OFFLINE_QUEUE_PATH=~/.gestao-tarefas-mcp/queue.sqlite
REQUEST_TIMEOUT_MS=5000
IGNORE_PREFEITURA=true
IGNORED_PROJECT_PATTERNS=prefeitura,pmsp,pref-,pm-,pm_

请勿将令牌、密码或 Cookie 放入版本控制的文件中。

功能

服务器提供以下工具:

  • 检测当前项目及其与系统的关联;

  • 列出项目、需求和冲刺;

  • 创建需求和子任务;

  • 更新子任务并查询需求详情;

  • 将需求关联到冲刺;

  • 使用离线队列操作,并稍后同步项目;

  • 检查连接性和身份验证状态。

标记为外部或属于市政厅的项目可以自动忽略。此行为由 IGNORE_PREFEITURAIGNORED_PROJECT_PATTERNS.gestaotarefas.json 文件控制。

运行

服务器使用 stdio,必须从构建目录运行:

npm run build
node dist/index.js

MCP 客户端的配置示例:

{
  "mcpServers": {
    "gestao-tarefas": {
      "command": "node",
      "args": ["/caminho/para/mcp-gestao-tarefas/dist/index.js"],
      "env": {
        "GESTAO_TAREFAS_API_URL": "https://seu-servidor-de-gestao.exemplo",
        "GESTAO_TAREFAS_API_TOKEN": "CONFIGURADO_LOCALMENTE",
        "OFFLINE_QUEUE_PATH": "~/.gestao-tarefas-mcp/queue.sqlite",
        "IGNORE_PREFEITURA": "true"
      }
    }
  }
}

修改代码后,运行 npm run build 并重启 MCP 客户端。

组件和流程的概述见 ARCHITECTURE.md

按开发代理配置

有权访问工作区的代理可以按照以下顺序配置服务器:

Configure o servidor MCP deste projeto.

1. Leia o README.md e identifique o cliente MCP em uso.
2. Use o diretório atual como diretório do projeto.
3. Instale as dependências apenas se necessário.
4. Execute npm run build.
5. Registre o servidor usando node dist/index.js e preserve as demais
   configurações existentes do cliente.
6. Solicite a URL do servidor e a autenticação caso ainda não estejam
   configuradas. Não exiba nem grave tokens ou senhas no chat.
7. Inicie o servidor ou informe que o cliente precisa ser reiniciado.

代理在覆盖现有配置或安装依赖项之前应请求确认。如果没有权限更改客户端配置,则应提供手动应用的说明。

项目配置

.gestaotarefas.json 文件必须创建在要集成到任务管理的仓库根目录中,与 .git 目录同级:

meu-projeto/
├── .git/
├── .gestaotarefas.json
├── package.json
└── src/

MCP 从当前目录开始查找该文件,并继续向上遍历父目录。因此,放置在公共文件夹中的配置也可以被多个仓库共享。备用名称 .gestao-tarefas.json 也被接受。

要将仓库链接到项目,请创建 meu-projeto/.gestaotarefas.json 并包含相应的标识符:

{
  "projeto_id": 1,
  "nome": "Gestão de Tarefas",
  "departamento": "TI"
}

要仅在该仓库中禁用 MCP,请使用相同的文件:

{
  "nome": "Projeto externo",
  "tipo": "externo",
  "ignorado": true,
  "motivo": "Projeto fora do escopo"
}

测试

npm test

测试套件涵盖身份验证、上下文检测、忽略项目的绕过、HTTP 通信、离线队列、同步和 MCP 工具。

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.

  • Manage projects, tasks, time tracking, and team collaboration through natural language.

  • Project management MCP for AI agents with safe task reads and writes.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bcosta19/mcp-gestao-tarefas'

If you have feedback or need assistance with the MCP directory API, please join our Discord server