Surechembl MCP Server

🚀 非公式SureChEMBL MCPサーバー

SureChEMBL化学特許データベースにアクセスするための包括的なモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、特許検索、化学物質の発見、構造解析、および特許インテリジェンス研究のためのツールを提供します。

開発者: Augmented Nature

🚀 クイックスタート

SureChEMBLは、化学構造とそれに関連する特許文書へのアクセスを提供する大規模な化学特許データベースです。このMCPサーバーは、SureChEMBLのAPIとのシームレスな統合を可能にし、以下の強力なツールを提供します。

• 特許インテリジェンス：化学特許の検索と分析
• 化学物質の発見：化合物とその特許のカバレッジを見つける
• 先行技術調査：既存の化学物質の開示を特定する
• 競争分析：企業による化学物質の開発を追跡する
• 構造活性分析：化学構造と特許請求項を相関させる

✨ 主な機能

🔍 文書と特許の検索（4つのツール）

• search_patents - テキスト、キーワード、または識別子で特許を検索します。
• get_document_content - 化学注釈付きの完全な特許文書の内容を取得します。
• get_patent_family - 特許ファミリーのメンバーと関係を取得します。
• search_by_patent_number - 特定の特許番号で検索します。

🧪 化学物質の検索と取得（4つのツール）

• search_chemicals_by_name - 名前または同義語で化学物質を検索します。
• get_chemical_by_id - SureChEMBL IDで詳細な化学物質情報を取得します。
• search_by_smiles - SMILES構造表記で化学物質を検索します。
• search_by_inchi - InChI/InChIキーで化学物質を検索します。

🖼️ 構造と可視化（2つのツール）

• get_chemical_image - 化学構造の画像を生成します。
• get_chemical_properties - 分子の特性と記述子を取得します。

📊 データのエクスポートと分析（2つのツール）

• export_chemicals - 化学データを一括エクスポートします（CSV/XML）。
• analyze_patent_chemistry - 特許内の化学物質の内容を分析します。

🔬 高度な分析ツール（3つのツール）

• get_chemical_frequency - 特許データベース全体での化学物質の頻度統計を取得します。
• search_similar_structures - 類似性検索を使用して構造的に類似した化学物質を見つけます。
• get_patent_statistics - 特許内の化学物質の内容の統計的概要を取得します。

📚 リソーステンプレート

• surechembl://document/{doc_id} - 特許文書の内容
• surechembl://chemical/{chem_id} - 化学化合物のデータ
• surechembl://family/{patent_id} - 特許ファミリーの情報
• surechembl://search/{query} - 検索結果

📦 インストール

前提条件

• Node.js 18+
• npmまたはyarn

依存関係のインストール

npm install

サーバーのビルド

npm run build

開発モード

npm run watch

💻 使用例

サーバーの起動

npm start

Claude Desktopでの使用

Claude Desktopの設定ファイルに追加します。 macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "surechembl-server": {
      "command": "node",
      "args": ["/path/to/surechembl-server/build/index.js"]
    }
  }
}

MCPインスペクターでの使用

npm run inspector

基本的な使用法

// アスピリン関連の化合物を検索
await use_mcp_tool({
  server_name: "surechembl-server",
  tool_name: "search_chemicals_by_name",
  arguments: {
    name: "aspirin",
    limit: 10,
  },
});

高度な使用法

// 化学注釈付きの完全な特許文書を取得
await use_mcp_tool({
  server_name: "surechembl-server",
  tool_name: "get_document_content",
  arguments: {
    document_id: "WO-2020096695-A1",
  },
});

// SMILESから構造画像を生成
await use_mcp_tool({
  server_name: "surechembl-server",
  tool_name: "get_chemical_image",
  arguments: {
    structure: "CC(=O)OC1=CC=CC=C1C(=O)O",
    width: 300,
    height: 200,
  },
});

// 特許内の化学注釈を分析
await use_mcp_tool({
  server_name: "surechembl-server",
  tool_name: "analyze_patent_chemistry",
  arguments: {
    document_id: "US-2021123456-A1",
  },
});

📚 ドキュメント

文書と特許の検索

search_patents

テキスト、キーワード、または識別子で特許を検索します。

パラメータ:

• query (文字列、必須): 検索クエリ
• limit (数値、オプション): 結果の制限 (1-1000、デフォルト: 25)
• offset (数値、オプション): 結果のオフセット (デフォルト: 0)

get_document_content

化学注釈付きの完全な特許文書の内容を取得します。

パラメータ:

• document_id (文字列、必須): 特許文書のID (例: WO-2020096695-A1)

get_patent_family

特許ファミリーのメンバーと関係を取得します。

パラメータ:

• patent_id (文字列、必須): ファミリーメンバーを見つけるための特許ID

search_by_patent_number

特定の特許番号で特許を検索します。

パラメータ:

• patent_number (文字列、必須): 特許または公開番号

化学物質の検索と取得

search_chemicals_by_name

名前、同義語、または一般名で化学物質を検索します。

パラメータ:

• name (文字列、必須): 化学物質の名前または同義語
• limit (数値、オプション): 結果の制限 (1-1000、デフォルト: 25)

get_chemical_by_id

SureChEMBL化学IDで詳細な化学物質情報を取得します。

パラメータ:

• chemical_id (文字列、必須): SureChEMBL化学ID (数値)

search_by_smiles

SMILES構造表記で化学物質を検索します。

パラメータ:

• smiles (文字列、必須): SMILES文字列
• limit (数値、オプション): 結果の制限 (1-1000、デフォルト: 25)

search_by_inchi

InChIまたはInChIキーで化学物質を検索します。

パラメータ:

• inchi (文字列、必須): InChI文字列またはInChIキー
• limit (数値、オプション): 結果の制限 (1-1000、デフォルト: 25)

構造と可視化

get_chemical_image

SMILESまたは他の構造表記から化学構造の画像を生成します。

パラメータ:

• structure (文字列、必須): SMILES文字列または構造表記
• height (数値、オプション): 画像の高さ（ピクセル） (デフォルト: 200)
• width (数値、オプション): 画像の幅（ピクセル） (デフォルト: 200)

get_chemical_properties

化学物質の分子特性と記述子を取得します。

パラメータ:

• chemical_id (文字列、必須): SureChEMBL化学ID

データのエクスポートと分析

export_chemicals

化学データをCSVまたはXML形式で一括エクスポートします。

パラメータ:

• chemical_ids (配列、必須): SureChEMBL化学IDの配列 (1-100)
• output_type (文字列、オプション): エクスポート形式 - 'csv' または 'xml' (デフォルト: csv)
• kind (文字列、オプション): IDの種類 - 'cid' または 'smiles' (デフォルト: cid)

analyze_patent_chemistry

特許文書内の化学物質の内容と注釈を分析します。

パラメータ:

• document_id (文字列、必須): 分析する特許文書のID

高度な分析ツール

get_chemical_frequency

特許データベース全体での化学物質の頻度統計を取得します。

パラメータ:

• chemical_id (文字列、必須): SureChEMBL化学ID

search_similar_structures

類似性検索を使用して構造的に類似した化学物質を見つけます。

パラメータ:

• reference_id (文字列、必須): 類似性検索のための参照化学ID
• threshold (数値、オプション): 類似性の閾値 (0.0-1.0、デフォルト: 0.7)
• limit (数値、オプション): 返す結果の数 (1-100、デフォルト: 25)

get_patent_statistics

特許内の化学物質の内容の統計的概要を取得します。

パラメータ:

• document_id (文字列、必須): 統計用の特許文書のID
• include_annotations (ブール値、オプション): 詳細な注釈統計を含める (デフォルト: true)

文書リソース

surechembl://document/{doc_id}

化学注釈付きの完全な特許文書の内容にアクセスします。

化学物質リソース

surechembl://chemical/{chem_id}

化学化合物の情報と特性にアクセスします。

特許ファミリーリソース

surechembl://family/{patent_id}

特許ファミリーのメンバーと関係にアクセスします。

検索リソース

surechembl://search/{query}

クエリの化学物質検索結果にアクセスします。

🔧 技術詳細

エラーハンドリング

サーバーには、以下の包括的なエラーハンドリングが含まれています。

• 無効なAPIパラメータ
• ネットワークタイムアウトと接続問題
• APIのレート制限
• 不正な化学構造
• 欠落している文書または化学物質

すべてのエラーは、説明的なメッセージと適切なエラーコードで返されます。

レート制限

サーバーはSureChEMBLのAPIレート制限を尊重します。

• 複雑なリクエストには30秒のタイムアウト
• 適切なリクエスト間隔
• 一時的な障害に対する自動リトライロジック

開発

プロジェクト構造

surechembl-server/
├── src/
│   └── index.ts          # メインサーバーの実装
├── build/                # コンパイルされたJavaScript
├── package.json          # 依存関係とスクリプト
├── tsconfig.json         # TypeScriptの設定
└── README.md            # このファイル

利用可能なスクリプト

• npm run build - TypeScriptをJavaScriptにコンパイルします。
• npm run watch - 開発用のウォッチモードです。
• npm run inspector - MCPインスペクターを実行します。
• npm start - サーバーを起動します。
• npm run dev - ウォッチ付きの開発モードです。

コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 適用可能な場合はテストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

サポート

問題や質問については、以下を参照してください。

• GitHubの問題: バグの報告と機能要求
• ドキュメント: SureChEMBL APIドキュメント

関連プロジェクト

• ChEMBL MCP Server - ChEMBL生物活性データベース
• PubChem MCP Server - PubChem化学データベース
• UniProt MCP Server - UniProtタンパク質データベース

引用

このプロジェクトを研究や出版物で使用する場合は、以下のように引用してください。

@misc{surechemblmcp2025, 
author = {Moudather Chelbi},
title = {SureChEMBL MCP Server},
year = {2025},
howpublished = {https://github.com/Augmented-Nature/SureChEMBL-MCP-Server},
note = {Accessed: 2025-06-29}

SureChEMBL MCP Server - モデルコンテキストプロトコルを通じて化学特許インテリジェンスを強化します。