Ask Helena
Official answers about Helena Bioinformatics and its products, with citations to public sources.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"ask-helena": {
"url": "https://api.helena.bio/ask/v1/mcp"
}
}
}원격 엔드포인트
https://api.helena.bio/ask/v1/mcpstreamable-http할 수 있는 일
도구 목록
도구 (3)
🟢search_public_knowledge(question, site, language, history, request_id)
Search the approved public pages of Helena Bioinformatics and its products. Return source-cited evidence.
입력 스키마
{
"type": "object",
"properties": {
"question": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"x-helena-maxUtf8Bytes": 8192
},
"site": {
"enum": [
"evidence",
"helena",
"folklore",
"all"
],
"default": "all"
},
"language": {
"type": "string",
"minLength": 2,
"maxLength": 35,
"pattern": "^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$"
},
"history": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"role",
"content"
],
"properties": {
"role": {
"enum": [
"user",
"assistant"
]
},
"content": {
"type": "string",
"minLength": 1,
"maxLength": 1024,
"x-helena-maxUtf8Bytes": 4096
}
}
}
},
"request_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"question"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"x-helena-maxBodyBytes": 16384,
"x-helena-maxHistoryTotalChars": 4096
}출력 스키마
{
"type": "object",
"properties": {
"canonical_response": {
"$ref": "#/$defs/AskResponseV1"
},
"protocol_metadata": {
"type": "object",
"additionalProperties": false,
"required": [
"adapter",
"adapter_version",
"protocol_version",
"canonical_contract_version"
],
"properties": {
"adapter": {
"const": "mcp"
},
"adapter_version": {
"const": "ask-helena-mcp-1"
},
"protocol_version": {
"const": "2026-07-28"
},
"canonical_contract_version": {
"const": 1
}
}
}
},
"required": [
"canonical_response",
"protocol_metadata"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"AskMode": {
"description": "Canonical execution modes.",
"enum": [
"answer",
"search"
],
"title": "AskMode",
"type": "string"
},
"DocumentStatus": {
"description": "Governed source publication states.",
"enum": [
"current",
"pending",
"historical"
],
"title": "DocumentStatus",
"type": "string"
},
"Evidence": {
"additionalProperties": false,
"description": "One ordered, snapshot-bound public evidence object.",
"properties": {
"source_id": {
"maxLength": 128,
"minLength": 1,
"title": "Source Id",
"type": "string"
},
"canonical_url": {
"format": "uri",
"maxLength": 2083,
"minLength": 1,
"title": "Canonical Url",
"type": "string"
},
"title": {
"maxLength": 300,
"minLength": 1,
"title": "Title",
"type": "string"
},
"section": {
"anyOf": [
{
"maxLength": 300,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Section"
},
"site": {
"$ref": "#/$defs/EvidenceSite"
},
"product": {
"maxLength": 64,
"minLength": 1,
"title": "Product",
"type": "string"
},
"language": {
"maxLength": 35,
"minLength": 2,
"pattern": "^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$",
"title": "Language",
"type": "string"
},
"status": {
"$ref": "#/$defs/DocumentStatus"
},
"excerpt": {
"maxLength": 1200,
"minLength": 1,
"title": "Excerpt",
"type": "string"
},
"rank": {
"maximum": 20,
"minimum": 1,
"title": "Rank",
"type": "integer"
},
"relevance": {
"$ref": "#/$defs/EvidenceRelevance"
},
"content_hash": {
"pattern": "^[0-9a-f]{64}$",
"title": "Content Hash",
"type": "string"
}
},
"required": [
"source_id",
"canonical_url",
"title",
"site",
"product",
"language",
"status",
"excerpt",
"rank",
"relevance",
"content_hash"
],
"title": "Evidence",
"type": "object"
},
"EvidenceRelevance": {
"description": "Public relevance classes.",
"enum": [
"primary",
"supporting"
],
"title": "EvidenceRelevance",
"type": "string"
},
"EvidenceSite": {
"description": "Source sites admitted to public evidence.",
"enum": [
"helena",
"folklore",
"evidence"
],
"title": "EvidenceSite",
"type": "string"
},
"Outcome": {
"description": "Closed version 1 result outcomes.",
"enum": [
"answered",
"evidence_only",
"partial",
"no_evidence",
"out_of_scope",
"unsafe_input",
"rate_limited",
"service_unavailable"
],
"title": "Outcome",
"type": "string"
},
"Warning": {
"additionalProperties": false,
"description": "Extensible version 1 warning.",
"properties": {
"code": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 300,
"minLength": 1,
"title": "Message",
"type": "string"
}
},
"required": [
"code",
"message"
],
"title": "Warning",
"type": "object"
},
"AskResponseV1": {
"additionalProperties": false,
"description": "Canonical version 1 response envelope.",
"properties": {
"contract_version": {
"const": "1",
"title": "Contract Version",
"type": "string"
},
"request_id": {
"format": "uuid",
"title": "Request Id",
"type": "string"
},
"outcome": {
"$ref": "#/$defs/Outcome"
},
"mode": {
"$ref": "#/$defs/AskMode"
},
"corpus_version": {
"anyOf": [
{
"maxLength": 128,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Corpus Version"
},
"answer": {
"anyOf": [
{
"maxLength": 8000,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Answer"
},
"evidence": {
"default": [],
"items": {
"$ref": "#/$defs/Evidence"
},
"maxItems": 20,
"title": "Evidence",
"type": "array"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"warnings": {
"default": [],
"items": {
"$ref": "#/$defs/Warning"
},
"maxItems": 8,
"title": "Warnings",
"type": "array"
}
},
"required": [
"contract_version",
"request_id",
"outcome",
"mode",
"generated_at"
],
"title": "AskResponse",
"type": "object"
}
}
}🟢ask_public_knowledge(question, site, language, history, request_id)
Answer questions about Helena Bioinformatics and its products from approved public sources, with citations and explicit limits. May return evidence only.
입력 스키마
{
"type": "object",
"properties": {
"question": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"x-helena-maxUtf8Bytes": 8192
},
"site": {
"enum": [
"evidence",
"helena",
"folklore",
"all"
],
"default": "all"
},
"language": {
"type": "string",
"minLength": 2,
"maxLength": 35,
"pattern": "^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$"
},
"history": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"role",
"content"
],
"properties": {
"role": {
"enum": [
"user",
"assistant"
]
},
"content": {
"type": "string",
"minLength": 1,
"maxLength": 1024,
"x-helena-maxUtf8Bytes": 4096
}
}
}
},
"request_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"question"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"x-helena-maxBodyBytes": 16384,
"x-helena-maxHistoryTotalChars": 4096
}출력 스키마
{
"type": "object",
"properties": {
"canonical_response": {
"$ref": "#/$defs/AskResponseV1"
},
"protocol_metadata": {
"type": "object",
"additionalProperties": false,
"required": [
"adapter",
"adapter_version",
"protocol_version",
"canonical_contract_version"
],
"properties": {
"adapter": {
"const": "mcp"
},
"adapter_version": {
"const": "ask-helena-mcp-1"
},
"protocol_version": {
"const": "2026-07-28"
},
"canonical_contract_version": {
"const": 1
}
}
}
},
"required": [
"canonical_response",
"protocol_metadata"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"AskMode": {
"description": "Canonical execution modes.",
"enum": [
"answer",
"search"
],
"title": "AskMode",
"type": "string"
},
"DocumentStatus": {
"description": "Governed source publication states.",
"enum": [
"current",
"pending",
"historical"
],
"title": "DocumentStatus",
"type": "string"
},
"Evidence": {
"additionalProperties": false,
"description": "One ordered, snapshot-bound public evidence object.",
"properties": {
"source_id": {
"maxLength": 128,
"minLength": 1,
"title": "Source Id",
"type": "string"
},
"canonical_url": {
"format": "uri",
"maxLength": 2083,
"minLength": 1,
"title": "Canonical Url",
"type": "string"
},
"title": {
"maxLength": 300,
"minLength": 1,
"title": "Title",
"type": "string"
},
"section": {
"anyOf": [
{
"maxLength": 300,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Section"
},
"site": {
"$ref": "#/$defs/EvidenceSite"
},
"product": {
"maxLength": 64,
"minLength": 1,
"title": "Product",
"type": "string"
},
"language": {
"maxLength": 35,
"minLength": 2,
"pattern": "^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$",
"title": "Language",
"type": "string"
},
"status": {
"$ref": "#/$defs/DocumentStatus"
},
"excerpt": {
"maxLength": 1200,
"minLength": 1,
"title": "Excerpt",
"type": "string"
},
"rank": {
"maximum": 20,
"minimum": 1,
"title": "Rank",
"type": "integer"
},
"relevance": {
"$ref": "#/$defs/EvidenceRelevance"
},
"content_hash": {
"pattern": "^[0-9a-f]{64}$",
"title": "Content Hash",
"type": "string"
}
},
"required": [
"source_id",
"canonical_url",
"title",
"site",
"product",
"language",
"status",
"excerpt",
"rank",
"relevance",
"content_hash"
],
"title": "Evidence",
"type": "object"
},
"EvidenceRelevance": {
"description": "Public relevance classes.",
"enum": [
"primary",
"supporting"
],
"title": "EvidenceRelevance",
"type": "string"
},
"EvidenceSite": {
"description": "Source sites admitted to public evidence.",
"enum": [
"helena",
"folklore",
"evidence"
],
"title": "EvidenceSite",
"type": "string"
},
"Outcome": {
"description": "Closed version 1 result outcomes.",
"enum": [
"answered",
"evidence_only",
"partial",
"no_evidence",
"out_of_scope",
"unsafe_input",
"rate_limited",
"service_unavailable"
],
"title": "Outcome",
"type": "string"
},
"Warning": {
"additionalProperties": false,
"description": "Extensible version 1 warning.",
"properties": {
"code": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"title": "Code",
"type": "string"
},
"message": {
"maxLength": 300,
"minLength": 1,
"title": "Message",
"type": "string"
}
},
"required": [
"code",
"message"
],
"title": "Warning",
"type": "object"
},
"AskResponseV1": {
"additionalProperties": false,
"description": "Canonical version 1 response envelope.",
"properties": {
"contract_version": {
"const": "1",
"title": "Contract Version",
"type": "string"
},
"request_id": {
"format": "uuid",
"title": "Request Id",
"type": "string"
},
"outcome": {
"$ref": "#/$defs/Outcome"
},
"mode": {
"$ref": "#/$defs/AskMode"
},
"corpus_version": {
"anyOf": [
{
"maxLength": 128,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Corpus Version"
},
"answer": {
"anyOf": [
{
"maxLength": 8000,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Answer"
},
"evidence": {
"default": [],
"items": {
"$ref": "#/$defs/Evidence"
},
"maxItems": 20,
"title": "Evidence",
"type": "array"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"warnings": {
"default": [],
"items": {
"$ref": "#/$defs/Warning"
},
"maxItems": 8,
"title": "Warnings",
"type": "array"
}
},
"required": [
"contract_version",
"request_id",
"outcome",
"mode",
"generated_at"
],
"title": "AskResponse",
"type": "object"
}
}
}🟢support_helena
Learn how an agent can support or spread Helena's free public scientific infrastructure through the separate Helena Good MCP. This is an explicit opt-in information action. It does not initiate payment, create a relay, or change Ask Helena evidence or answers.
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}출력 스키마
{
"type": "object",
"additionalProperties": true
}커뮤니티
증거