AI导哈

AI代理开发工作流程工具

个人Model Context Protocol服务器，为AI代理提供开发工作流程工具，包括GitHub项目管理、常规提交、静态文件服务、nvm感知命令执行、视觉回归测试、Jira/Confluence集成等。

  • by HoukasaurusRex
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 HoukasaurusRex/jt-mcp-server

使用说明

jt mcp服务器

个人 模型上下文协议 提供AI代理开发工作流工具的服务器——GitHub项目管理、常规提交、静态文件服务、nvm感知命令执行、可视化回归测试、Jira/Confluence集成等。

快速开始

npx @houkasaurusrex/jt-mcp-server

添加到克劳德代码

在您的项目中 .claude/settings.json:

{
  "mcpServers": {
    "jt-mcp": {
      "command": "npx",
      "args": ["-y", "@houkasaurusrex/jt-mcp-server"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}",
        "NETLIFY_AUTH_TOKEN": "${NETLIFY_AUTH_TOKEN}",
        "ATLASSIAN_DOMAIN": "${ATLASSIAN_DOMAIN}",
        "ATLASSIAN_EMAIL": "${ATLASSIAN_EMAIL}",
        "ATLASSIAN_API_TOKEN": "${ATLASSIAN_API_TOKEN}"
      }
    }
  }
}

工具

开发工作流程

工具 说明
dev_serve 在端口上提供目录。杀死该端口上的现有进程，启动 serve -s，等待200响应，返回URL
dev_serve_stop 按端口停止开发服务器
dev_run 运行一个shell命令，其中包含可选的nvm-Node版本、工作目录和env变量。直接从以下位置解析节点二进制文件 ~/.nvm/versions/node/.
dev_port 港口管理-- check 什么在使用端口， kill 在端口上处理， wait_ready 直到端口接受连接。
dev_worktree Git工作树生命周期-- create （结账+安装deps）， build （运行构建命令）， remove （清理）。Worktree居住在 .claude/worktrees/<branch>/.
dev_install 使用正确的包管理器安装项目依赖项（从锁文件中自动检测到）。支持CI的冻结/不可变锁文件模式
dev_script 使用正确的包管理器按名称运行package.json脚本。验证脚本是否存在，并列出出现错误时可用的脚本。
dev_deps 使用正确的包管理器添加或删除npm包。支持devDependencies。
dev_visual_regression 编排一个完整的Playwright视觉回归循环：提供参考目录、捕获基线、提供测试目录、运行比较、返回结果。

搜索与探索

工具 说明
dev_grep 使用上下文行、glob过滤搜索文件内容中的模式（正则表达式或文字）。尊重 .gitignore。使用ripgrep。
dev_find 按glob模式查找文件/目录。尊重 .gitignore.用途 fd 随着 git ls-files 退路。
dev_read 使用行号、可选行范围、二进制检测和路径遍历保护读取文件内容。
dev_tree 显示目录树结构。跳绳 node_modules, .git、构建伪影和其他常见噪声。

GitHub

工具 说明
github_project_next_issue 从GitHub ProjectV2板上获取最旧的“Todo”问题。
github_project_set_status 更新项目项的状态（待办/进行中/完成）。
github_project_complete_issue 关闭GitHub问题，并在一次调用中将其项目板状态设置为“完成”。
github_create_pr 通过以下方式创建拉取请求 gh CLI。

Git

工具 说明
git_conventional_commit 暂存文件并创建常规提交。验证消息格式，拒绝暂存 .env 或 node_modules.

吉拉（via acli CLI）

需要 Atlassian命令行界面 --奔跑 acli auth login 一次验证。

工具 说明
jira_search JQL、可配置字段和结果限制的搜索问题。
jira_get_issue 按密钥获取问题的完整详细信息。
jira_create_issue 创建问题（任务、Bug、故事、史诗），包括描述、受让人、标签、父母。
jira_transition 过渡问题状态（例如“进行中”、“完成”）。
jira_add_comment 为问题添加评论。
jira_assign 分配(user@email, @me)或取消分配问题。

汇流（REST API）

需要 ATLASSIAN_DOMAIN, ATLASSIAN_EMAIL，以及 ATLASSIAN_API_TOKEN env变量。

工具 说明
confluence_search 使用CQL搜索页面，返回ID、标题、空格、摘录。
confluence_get_page 读取页面内容（存储XHTML、渲染HTML或ADF）。
confluence_create_page 在空间中创建页面，子页面可选父页面。
confluence_update_page 使用自动递增的版本更新页面正文/标题。

外壳

工具 说明
shell_lint 在shell脚本上运行ShellCheck。返回包含文件、行、级别和消息的结构化JSON结果。

Netlify

工具 说明
netlify_deploy_status 检查Netlify站点的最新部署状态。
netlify_build_log 获取构建/部署日志（最后N行），用于诊断失败的部署和CI问题。
netlify_function_log 流式传输最近的无服务器函数调用日志以进行调试。
netlify_list_deploys 列出最近部署的状态、分支、上下文和错误信息。
netlify_list_functions 列出站点部署的所有无服务器功能。

记忆（知识图谱）

工具 说明
memory_add_entities 使用名称、类型和观察值创建实体（首选项、工具、项目、约定）。
memory_add_relations 在实体之间创建类型化的有向关系（例如PREFERS、USES、AVOIDS）。
memory_add_observations 向现有实体添加事实或注释。
memory_query 按名称、类型或关系搜索和遍历知识图。
memory_delete 删除实体（级联）、关系或观察。
memory_export 将整个图形导出为JSON格式。
memory_import 从JSON导入图形（合并或替换）。
memory_track_action 跟踪模式检测的可重复操作（构建、测试、部署、lint）。
memory_suggest_tools 分析跟踪的行动，找出可能成为新MCP工具的模式。

使用内存数据库

内存工具提供了一个持久的知识图，代理可以使用它来记住用户偏好、项目约定和会话中的事实。数据存储在SQLite数据库中 ~/.jt-memory/memory.db 汽车出口到 ~/.jt-memory/memory.json 每一次写作。

在项目中启用内存

将以下内容添加到您的项目中 CLAUDE.md 因此代理知道在每个会话开始时使用内存：

## Memory

This project uses `@houkasaurusrex/jt-mcp-server` memory tools. At the start of every session:
1. Call `memory_query` with no filters to load all stored context
2. Use the returned entities, observations, and relations to inform your work
3. When you learn new user preferences or project conventions, store them with `memory_add_entities` and `memory_add_observations`

运作原理

  • 实体 有一个名称、类型和观察结果（事实）。类型包括 preference, convention, project, tool, workflow等等。
  • 关系 是实体之间的有向边（例如。 JT --更喜欢--> Yarn Berry).
  • 观察 是附加到实体的字符串事实（例如“始终使用单行常规提交”）。
  • 数据库持续存在于 ~/.jt-memory/memory.db 在所有项目和会议中。
  • 每次写入汽车导出到 ~/.jt-memory/memory.json 作为人类可读的备份。
  • 用以下内容覆盖路径 JT_MEMORY_DB 和 JT_MEMORY_EXPORT_PATH env变量。

行动跟踪

内存系统可以跟踪代理在项目中执行的可重复操作，并建议模式何时应该成为专用的MCP工具。

跟踪行动：

{ "command": "yarn lint --fix", "description": "Auto-fix lint issues", "project": "my-app", "tags": ["lint", "fix"], "category": "lint" }

检查工具建议：

{ "min_occurrences": 3, "min_projects": 2 }

返回超过阈值的精确命令匹配和基于标记的集群，并建议哪些模式是新工具的良好候选者。

将以下内容添加到您的项目中 CLAUDE.md 要启用动作跟踪：

### Action Tracking

When performing substantive, repeatable actions (build, test, deploy, lint, format, git workflow),
call `memory_track_action` with command, description, project, tags, and category.
Do NOT track trivial commands (ls, cd, file reads, one-off searches).

Periodically call `memory_suggest_tools` to discover patterns worth converting to MCP tools.

示例：存储首选项

{ "entities": [{ "name": "commits", "type": "convention", "observations": ["Single-line conventional commits", "No Co-Authored-By trailers"] }] }

示例：会话开始时的查询

{}                                // returns all entities
{ "type": "preference" }         // returns only preferences
{ "name": "yarn", "depth": 2 }   // traverse 2 levels from matching entities

环境变量

变量 必需
GITHUB_TOKEN GitHub工具（PAT与 repo + project 范围）
NETLIFY_AUTH_TOKEN Netlify工具
ATLASSIAN_DOMAIN 汇流工具（例如。 mycompany.atlassian.net)
ATLASSIAN_EMAIL 汇流工具（帐户电子邮件）
ATLASSIAN_API_TOKEN 汇流工具(创建一个)

Jira工具使用 acli CLI处理自己的身份验证--run acli auth login 一次。

发展

yarn install
yarn build
yarn test
yarn test <pattern>   # e.g. yarn test dev-port

许可证

麻省理工学院

相关 MCP