xby-cellosaurus

Readme

# xby-cellosaurus

DeepSeek Harness (DSH) 的插件：细胞系知识资源服务

Cellosaurus MCP Server是一个非官方的模型上下文协议服务器，用于访问SIB Cellosaurus细胞系知识资源，提供细胞系搜索、详细信息获取和数据库版本信息等功能。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **search_cell_lines** — Search for cell lines in the Cellosaurus database.

Use Solr search syntax to find cell lines by various criteria.

Examples
--------
- Basic name search: "id:HeLa" or "sy:HeLa"
- Species filter: "ox:human" or "ox:9606"
- Disease filter: "di:cancer" or "di:hepatoblastoma"
- Combined: "ox:human di:cancer ca:cancer"
- Site filter: "derived-from-site:liver"

Args:
    query: Search query using Solr syntax (default: "id:HeLa")
    fields: List of fields to return (e.g., ["id", "ac", "ox", "di"])
    start: Starting index for pagination (default: 0)
    rows: Number of results to return (default: 10, max: 1000)
    sort_order: Sort order (e.g., "group asc,derived-from-site desc")

Returns
-------
    Dictionary containing search results with cell line information
- **get_cell_line_info** — Get detailed information about a specific cell line by its accession number.

Args:
    accession: Cell line accession number (e.g., "CVCL_0030" for HeLa)
    fields: List of specific fields to return (e.g., ["id", "ac", "str", "di"])

Returns
-------
    Dictionary containing detailed cell line information
- **get_release_info** — Get information about the current Cellosaurus database release.

Returns
-------
    Dictionary containing release version, date, and statistics
- **find_cell_lines_by_disease** — Find cell lines derived from patients with a specific disease.

Args:
    disease: Disease name or term (e.g., "hepatoblastoma", "cancer", "leukemia")
    species: Species filter (default: "human", can be "mouse", "rat", etc.)
    fields: Specific fields to return
    limit: Maximum number of results (default: 10)

Returns
-------
    Dictionary containing cell lines associated with the disease
- **find_cell_lines_by_tissue** — Find cell lines derived from a specific tissue or organ.

Args:
    tissue: Tissue/organ name (e.g., "liver", "lung", "breast", "brain")
    species: Species filter (default: "human")
    fields: Specific fields to return
    limit: Maximum number of results (default: 10)

Returns
-------
    Dictionary containing cell lines from the specified tissue
- **list_available_fields** — Get a list of all available fields that can be requested from the Cellosaurus API.

Returns
-------
    Dictionary mapping field names to their descriptions

## 安装

### 方式一：从 GitHub 直接安装（推荐）

```bash
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-cellosaurus
```

### 方式二：从本地目录安装（开发模式）

```bash
# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-cellosaurus
```

### 方式三：通过 cordis.patch.yml 开发调试

```bash
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
```



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。