molclaw-proteinmpnn-tool
Design or score protein sequences from PDB structures using a ProteinMPNN workflow wrapper.
- License 许可
- MIT
- 最近更新
- 2026-10-09
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- molclaw-proteinmpnn-tool
- license
- MIT license
- metadata
- { "skill-author": "PJLab" }
- description
- Design or score protein sequences from PDB structures using a ProteinMPNN workflow wrapper.
03 SKILL.md 正文
ProteinMPNN Sequence Design
Note:
- Local files are not directly accessible by the server. Please upload them to the server using
molclaw-file-transferbefore execution. - For PDB file inputs, it is recommended to preprocess them using
molclaw-pdbfixerbefore execution. - Please refer to skill
molclaw-scp-serverto complete tool invocation.
Usage
1. Protein Sequence Design and Scoring
The description of tool proteinmpnn_tool.
Run ProteinMPNN sequence design or scoring from protein structures with optional chain constraints and amino-acid controls.
Args:
pdb_input (str): Input PDB file path or a directory containing multiple PDB files.
model_name (str): Model name in {v_48_002, v_48_010, v_48_020, v_48_030} (default: "v_48_020").
use_soluble (bool): Use soluble-protein model weights (default: False).
ca_only (bool): Run CA-only model mode (default: False).
num_seq (int): Number of sequences generated per target (default: 8).
sampling_temp (str): Sampling temperature string; supports multiple values separated by spaces (default: "0.1").
chains_to_design (str): Chain IDs to redesign, e.g. "A" or "A C" (default: "").
fixed_positions (str): Residue position lists for chain constraints (default: "").
specify_non_fixed (bool): Interpret listed positions as designable positions instead of fixed positions (default: False).
homooligomer (bool): Enable tied-position design for homooligomers (default: False).
omit_aas (str): Globally omitted amino acids (default: "X").
bias_aa (str): Amino-acid bias JSON string (default: "").
score_only (bool): Run scoring-only mode instead of sequence generation (default: False).
path_to_fasta (str): FASTA path used in scoring mode (default: "").
save_probs (bool): Save probability matrices (default: False).
seed (int): Random seed (default: 0).
skip_check (bool): Skip dependency checks in source pipeline (default: False).
dry_run (bool): Validate inputs and create run directory without executing the pipeline (default: False).
Return:
status (str): "success", "error", or "partial_success".
msg (str): Human-readable execution summary.
output_dir (str): Unique run directory under tool_result/proteinmpnn_tool_result.
results_dir (str): Result directory path under output_dir/results.
model_name (str): Effective model name used in this run.
num_seq (int): Effective number of sequences used in this run.
sampling_temp (str): Effective sampling temperature used in this run.
score_only (bool): Effective scoring mode flag.
dry_run (bool): Effective dry-run flag.
output_files (dict): Produced output paths such as seqs/scores/probs directories.
metrics (dict): Summary metrics, including sequence/score/prob file counts when available.
How to use tool proteinmpnn_tool :
response = await client.session.call_tool(
"proteinmpnn_tool",
arguments={
"pdb_input": "/path/to/input.pdb",
"num_seq": 8,
"sampling_temp": "0.1",
"dry_run": True
}
)
result = client.parse_result(response)
key_output = result["results_dir"]
Example parameter sets
# 1) Main mode
{
"pdb_input": "/path/to/input.pdb",
"model_name": "v_48_020",
"num_seq": 8,
"sampling_temp": "0.1",
"chains_to_design": "A",
"dry_run": False
}
# 2) Variant mode
{
"pdb_input": "/path/to/input.pdb",
"score_only": True,
"path_to_fasta": "relative/path/to/sequences.fasta",
"seed": 42,
"dry_run": False
}
04 同仓库更多 Skills
molclaw-smiles-valid-check
Check if the input molecule SMILES string is valid.
molclaw-skill-template-writer
Formats extracted execution patterns into standard MolClaw skill documents. Accepts structured input from the Skill Crystallization Meta-Workflow (L2-12) and outputs a properly formatted L1 or L2 skill document conforming to MolClaw conventions. This skill ensures that auto-generated skills are structurally identical to expert-curated skills, enabling seamless integration into the skill matching and loading pipeline.
molclaw-sequence-valid-check
Check if the input protein sequence is valid.
molclaw-scp-server
All tools utilized within molclaw skills connect via the MCP protocol. This skill serves as a unified guide for using the MCP Server. This skill must be loaded to create the MCP server before invoking any tools.
molclaw-run-bioemu
Run BioEmu sequence sampling and extract ensemble structures for downstream conformation analysis.
molclaw-rgroup-sampling
Generate new molecules sampling from the input scaffold.