AI导哈

笔记管理服务

parchmark-mcp是一个用于通过Claude Code/Desktop管理ParchMark笔记的服务器服务，提供笔记的创建、读取、更新和删除功能。

  • by TejGandham
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 TejGandham/parchmark-mcp

使用说明

巴克马克mcp

MCP服务器，用于通过克劳德代码/桌面管理ParchMark笔记。

安装

# Run directly
uvx --from git+https://github.com/TejGandham/parchmark-mcp parchmark-mcp

# Or install
pip install git+https://github.com/TejGandham/parchmark-mcp

升级

警告： 这 uvx --from git+… 上面的安装是 未固定的但是 uvx 缓存已解析的 git提交并重用它——确实如此 不 自行重新提取新的提交。新版本不会 出现，直到您破坏缓存：

# Re-fetch the default-branch HEAD and rebuild the cached environment
uvx --refresh --from git+https://github.com/TejGandham/parchmark-mcp parchmark-mcp
# …or just clear this package's cache so the next launch re-resolves
uv cache clean parchmark-mcp

然后 重新启动MCP客户端 （克劳德代码/桌面，opencode），因此它重新启动了服务器——a 正在运行的客户端会保留旧进程，直到重新启动。看 docs/INSTALL.md 详情及 pip/uv pip 等效物。

配置

环境变量

变量 描述 示例
PARCHMARK_URL API基本URL https://parchmark.example.com/api
PARCHMARK_USERNAME 您的用户名 myuser
PARCHMARK_PASSWORD 您的密码 mypassword

Claude代码设置

claude mcp add parchmark -s user \
  -e "PARCHMARK_URL=https://your-instance/api" \
  -e "PARCHMARK_USERNAME=your-user" \
  -e "PARCHMARK_PASSWORD=your-pass" \
  -- uvx --from git+https://github.com/TejGandham/parchmark-mcp parchmark-mcp

或手动添加到 .mcp.json:

{
  "mcpServers": {
    "parchmark": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/TejGandham/parchmark-mcp", "parchmark-mcp"],
      "env": {
        "PARCHMARK_URL": "https://parchmark.example.com/api",
        "PARCHMARK_USERNAME": "your-username",
        "PARCHMARK_PASSWORD": "your-password"
      }
    }
  }
}

工具

工具 参数 说明
list_notes 无 列出所有注释（仅元数据）
get_note note_id 获取包含完整内容的特定笔记
create_note content 从markdown创建新笔记
update_note note_id, content 更新现有注释
delete_note note_id 删除注释

建筑

parchmark-mcp/
├── src/parchmark_mcp/
│   ├── __init__.py      # Package version
│   ├── server.py        # FastMCP server & tools
│   ├── client.py        # ParchMark API client
│   └── models.py        # Pydantic models
├── tests/
│   ├── test_models.py   # Model tests
│   ├── test_client.py   # Client tests (mocked)
│   └── test_server.py   # Server tests (mocked)
└── pyproject.toml       # Package config

发展

# Clone and install
git clone https://github.com/TejGandham/parchmark-mcp
cd parchmark-mcp
uv sync --all-extras

# Run tests
uv run pytest tests/ -v

# Lint & format
uv run ruff check src/ tests/
uv run ruff format src/ tests/

# Type check
uv run pyright src/ tests/

质量门

预提交钩子强制执行：

  • ruff -自动补齐
  • ruff-format -代码格式
  • pyright --strict -类型检查

技术栈

  • FastMCP -Python MCP框架
  • httpx -异步HTTP客户端
  • 派单 -数据验证和模型
  • 正确 -静态类型检查（严格模式）
  • 颈毛 -装订和格式化
  • pytest -使用异步支持进行测试

许可证

麻省理工学院

相关 MCP