jira-service MCP server

jira-service MCP server

site icon
2024.12.27 0
Python笔记管理文本处理交流协作
jira-service MCP server 是一个基于 MCP 协议的服务项目,主要用于实现简单的笔记存储系统。它提供了自定义的 note:// URI 方案来访问单个笔记,每个笔记资源包含名称、描述和纯文本类型。服务器还提供了总结笔记的功能,并支持通过工具添加新笔记。
View on GitHub

Overview

基本能力

产品定位

jira-service MCP server 是一个基于 MCP 协议的笔记存储和总结服务。

核心功能

  1. 笔记存储系统
  2. 自定义 note:// URI 方案访问单个笔记
  3. 每个笔记资源包含名称、描述和纯文本类型
  4. 笔记总结功能
  5. 提供 summarize-notes 提示,可生成所有存储笔记的摘要
  6. 可选 "style" 参数控制详细程度(brief/detailed)
  7. 笔记添加工具
  8. add-note 工具可添加新笔记到服务器
  9. 需要 "name" 和 "content" 作为必需参数

适用场景

  1. 需要存储和管理简单笔记的场景
  2. 需要自动总结多个笔记内容的场景
  3. 需要集成笔记功能的 MCP 系统

工具列表

  1. add-note
  2. 能力:添加新笔记到服务器
  3. 参数:"name"(名称)和 "content"(内容)
  4. 效果:更新服务器状态并通知客户端资源变更

常见问题解答

  1. 调试困难
  2. 由于 MCP 服务器通过 stdio 运行,调试可能具有挑战性
  3. 推荐使用 MCP Inspector 进行调试

使用教程

使用依赖

  1. 需要安装 Claude Desktop
  2. MacOS 配置文件路径:~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows 配置文件路径:%APPDATA%/Claude/claude_desktop_config.json

安装教程

  1. 开发/未发布服务器配置
"mcpServers": {
  "jira-service": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/eddie/Chima/Research/MCP/jira_service",
      "run",
      "jira-service"
    ]
  }
}
  1. 已发布服务器配置
"mcpServers": {
  "jira-service": {
    "command": "uvx",
    "args": [
      "jira-service"
    ]
  }
}

调试方式

  1. 使用 MCP Inspector 进行调试:
npx @modelcontextprotocol/inspector uv --directory /Users/eddie/Chima/Research/MCP/jira_service run jira-service
  1. 启动后,检查浏览器中显示的 URL 开始调试

开发指南

构建和发布

  1. 同步依赖并更新锁文件:
uv sync
  1. 构建包分发:
uv build
  1. 发布到 PyPI:
uv publish
  • 需要设置 PyPI 凭证(通过环境变量或命令标志)

许可证

None