芬兰吉拉mcp
一个MCP（模型上下文协议）服务器，允许AI代理搜索和读取Jira票证。支持具有基本身份验证的自托管Jira。只读--无创建、更新或删除操作。
暴露的工具
| 工具 | 说明 |
|---|---|
search_tickets | 使用JQL查询搜索Jira票证。返回匹配的票证，包括密钥、URL、标题、描述、状态、问题类型、优先级、受让人、截止日期和家长信息 |
get_ticket | 通过问题密钥获取单个Jira票证的完整详细信息 |
search_tickets 参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
jql | string | Yes | JQL查询字符串（例如。 project = PROJ AND status = Open ORDER BY created DESC) |
max_results | number | 否 | 返回的最大结果数（1-100，默认值20） |
get_ticket 参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
issue_key | string | Yes | Jira问题密钥（例如。 PROJ-123) |
______________________________________________________________________
先决条件
- Node.js 18或更高版本
- 使用有效凭据访问Jira实例（自托管）
______________________________________________________________________
设置
1.克隆并安装依赖项
git clone https://github.com/dobadevv/finviet-jira-mcp.git
cd finviet-jira-mcp
npm install2.建造
npm run build编译后的输出在 dist/.
3.验证（可选）
JIRA_BASE_URL=https://hotro.finviet.com.vn \
JIRA_USERNAME=your-username \
JIRA_PASSWORD=your-password \
node dist/index.js您应该看到：
finviet-jira-mcp server started (stdio)______________________________________________________________________
配置
服务器在启动时从环境变量中读取凭据：
| 变量 | 必填 | 示例 |
|---|---|---|
JIRA_BASE_URL | 是的 | https://hotro.finviet.com.vn |
JIRA_USERNAME | 是的 | john.doe |
JIRA_PASSWORD | 是的 | s3cr3t |
______________________________________________________________________
添加到您的代理
光标
打开 光标设置→ MCP （或编辑 ~/.cursor/mcp.json)并添加：
{
"mcpServers": {
"finviet_jira": {
"command": "node",
"args": ["/absolute/path/to/finviet-jira-mcp/dist/index.js"],
"env": {
"JIRA_BASE_URL": "https://hotro.finviet.com.vn",
"JIRA_USERNAME": "your-username",
"JIRA_PASSWORD": "your-password"
}
}
}
}重新启动游标。这 search_tickets 和 get_ticket 工具将出现在代理的工具列表中。
______________________________________________________________________
克劳德桌面版
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"finviet_jira": {
"command": "node",
"args": ["/absolute/path/to/finviet-jira-mcp/dist/index.js"],
"env": {
"JIRA_BASE_URL": "https://hotro.finviet.com.vn",
"JIRA_USERNAME": "your-username",
"JIRA_PASSWORD": "your-password"
}
}
}
}重新启动克劳德桌面。这些工具将在每次对话中自动可用。
______________________________________________________________________
克劳德代码（CLI）
将服务器添加到您的项目或全局Claude Code配置中：
claude mcp add finviet_jira node /absolute/path/to/finviet-jira-mcp/dist/index.js \
-e JIRA_BASE_URL=https://hotro.finviet.com.vn \
-e JIRA_USERNAME=your-username \
-e JIRA_PASSWORD=your-password验证服务器是否已注册：
claude mcp list