巴克马克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配置
环境变量
| 变量 | 描述 | 示例 |
|---|---|---|
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-类型检查
技术栈
- 快速MCP -Python MCP框架
- HTTPX -异步HTTP客户端
- 派丹蒂克 -数据验证和模型
- 正确 -静态类型检查（严格模式）
- 颈毛 -装订和格式化
- pytest -使用异步支持进行测试
许可证
麻省理工学院