Materials Project MCP

🚀 Materials Project MCP

Materials Project MCP 是一款基於 fastmcp 的工具，用於針對 Materials Project 數據庫中的數據編寫提示信息。

🚀 快速開始

本工具可幫助你輕鬆操作 Materials Project 數據庫中的數據，下面將為你介紹其安裝、使用等相關內容。

✨ 主要特性

• 基於 fastmcp，能快速處理 Materials Project 數據庫中的數據。
• 提供命令行接口和 Python 代碼調用兩種使用方式。

📦 安裝指南

你可以從源代碼安裝該包，有以下兩種方式：

常規安裝

pip install -e .

使用 uv 安裝

uv pip install -e .

💻 使用示例

基礎用法

使用命令行接口

mp-mcp

在 Python 代碼中導入使用

from materials_project_mcp.main import create_mcp

mcp = create_mcp()
mcp.run()

高級用法

下面展示一個簡單示例，演示如何直接使用 MCP 工具：

import os
import json
from materials_project_mcp.tools import (
    get_materials_with_elements,
    get_material_details,
    find_materials_by_formula
)

# Set your API key
os.environ["MP_API_KEY"] = "your_api_key_here"
# Or load it from a file
# with open("~/materials_project_api.key", "r") as f:
#     os.environ["MP_API_KEY"] = f.read().strip()

# Function to print JSON data in a readable format
def print_json(data):
    print(json.dumps(data, indent=2))

# Find materials containing Fe and O
print("\n=== Finding materials containing Fe and O ===")
materials = get_materials_with_elements(
    elements=["Fe", "O"],
    max_records=3
)
print_json(materials)

# Get details for a specific material
if materials:
    material_id = materials[0]["material_id"]
    print(f"\n=== Getting details for material {material_id} ===")
    details = get_material_details(material_id)
    print_json(details)

# Find materials with a specific formula
print("\n=== Finding materials with formula Fe2O3 ===")
formula_materials = find_materials_by_formula(
    formula="Fe2O3",
    max_records=3
)
print_json(formula_materials)

📚 詳細文檔

API Key 設置

Materials Project API 需要 API Key，你可以通過以下幾種方式設置 API Key：

直接傳遞給 MPRester

from mp_api.client import MPRester
with MPRester("your_api_key_here") as mpr:
    # do stuff with mpr

設置為環境變量

export MP_API_KEY="your_api_key_here"

🔧 技術細節

本地開發環境搭建

# Clone the repository
git clone https://github.com/justaddcoffee/materials-project-mcp.git
cd materials-project-mcp

# Install development dependencies
uv pip install -e ".[dev]"

運行測試

pytest