| Name | battery-mcp JSON |
| Version |
0.0.2
JSON |
| download |
| home_page | None |
| Summary | A Model Context Protocol server providing tools to search and verify battery materials |
| upload_time | 2025-09-16 05:06:15 |
| maintainer | None |
| docs_url | None |
| author | Menlo Research |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
automation
http
llm
mcp
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Battery MCP Server
A Model Context Protocol server that provides battery materials validation capabilities. This server enables LLMs to verify invented bettery materials are novel and valid or not.
> [!CAUTION]
> This server can access local/internal IP addresses and may represent a security risk. Exercise caution when using this MCP server to ensure this does not expose any sensitive data.
## Available Tools
### `search_material`
Searches and returns relevant battery materials from the database.
**Parameters:**
- `formula` (string, required): Formula query for battery materials (e.g., "LiCoO2")
- `n` (integer, optional): Number of results to return (default: 5, min: 1, max: 100)
---
### `verify_input_material`
Validates whether a material exists in the database.
**Parameters:**
- `original_material` (string, required): Material formula to validate (e.g., "LiFePO4")
---
### `battery_material_validation`
Parses and validates battery materials from a query, comparing them against a reference material.
**Parameters:**
- `original_material` (string, required): Reference battery material (e.g., "LiCoO2")
- `query` (string, required): Comma-separated list of proposed materials (e.g., "Li2B4O7, Li1.06Ti2O4")
## Installation
This MCP server requires API key from [materials project](https://next-gen.materialsproject.org/), you can get api key and use it with env variable `MP_API_KEY`
```
export MP_API_KEY=
```
### Using uv (recommended)
When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *[battery-mcp](https://github.com/nguyenhoangthuan99/battery-mcp.git)*.
### Using PIP
Alternatively you can install `battery-mcp` via pip:
```
pip install battery-mcp
```
After installation, you can run it as a script using:
```
python -m battery-mcp
```
### Running with streamable-http
You can also deploy mcp as http server with streamable-http transport protocol
```
python -m battery-mcp --transport http --http-host 0.0.0.0 --http-port 8080
```
or using `uvx`
```
uvx battery-mcp --transport http --http-host 0.0.0.0 --http-port 8080
```
## Configuration
### Configure for Claude.app
Add to your Claude settings:
<details>
<summary>Using uvx</summary>
```json
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["battery-mcp"]
}
}
}
```
</details>
<details>
<summary>Using pip installation</summary>
```json
{
"mcpServers": {
"fetch": {
"command": "python",
"args": ["-m", "battery-mcp"]
}
}
}
```
</details>
## License
battery-mcp is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Raw data
{
"_id": null,
"home_page": null,
"name": "battery-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Alex Nguyen <alex@menlo.ai>",
"keywords": "automation, http, llm, mcp",
"author": "Menlo Research",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/1e/25/01f7cef102fbe6f91bae59efb0f25c12bcb8ae51e4f8a4a35e5c42466b42/battery_mcp-0.0.2.tar.gz",
"platform": null,
"description": "# Battery MCP Server\n\nA Model Context Protocol server that provides battery materials validation capabilities. This server enables LLMs to verify invented bettery materials are novel and valid or not.\n\n> [!CAUTION]\n> This server can access local/internal IP addresses and may represent a security risk. Exercise caution when using this MCP server to ensure this does not expose any sensitive data.\n\n\n## Available Tools\n\n### `search_material`\nSearches and returns relevant battery materials from the database.\n\n**Parameters:**\n- `formula` (string, required): Formula query for battery materials (e.g., \"LiCoO2\")\n- `n` (integer, optional): Number of results to return (default: 5, min: 1, max: 100)\n\n---\n\n### `verify_input_material`\nValidates whether a material exists in the database.\n\n**Parameters:**\n- `original_material` (string, required): Material formula to validate (e.g., \"LiFePO4\")\n\n---\n\n### `battery_material_validation`\nParses and validates battery materials from a query, comparing them against a reference material.\n\n**Parameters:**\n- `original_material` (string, required): Reference battery material (e.g., \"LiCoO2\")\n- `query` (string, required): Comma-separated list of proposed materials (e.g., \"Li2B4O7, Li1.06Ti2O4\")\n\n\n## Installation\n\nThis MCP server requires API key from [materials project](https://next-gen.materialsproject.org/), you can get api key and use it with env variable `MP_API_KEY`\n\n```\nexport MP_API_KEY=\n```\n\n### Using uv (recommended)\n\nWhen using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will\nuse [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *[battery-mcp](https://github.com/nguyenhoangthuan99/battery-mcp.git)*.\n\n### Using PIP\n\nAlternatively you can install `battery-mcp` via pip:\n\n```\npip install battery-mcp\n```\n\nAfter installation, you can run it as a script using:\n\n```\npython -m battery-mcp\n```\n\n### Running with streamable-http\n\nYou can also deploy mcp as http server with streamable-http transport protocol\n\n```\npython -m battery-mcp --transport http --http-host 0.0.0.0 --http-port 8080\n```\n\nor using `uvx`\n```\nuvx battery-mcp --transport http --http-host 0.0.0.0 --http-port 8080\n```\n## Configuration\n\n### Configure for Claude.app\n\nAdd to your Claude settings:\n\n<details>\n<summary>Using uvx</summary>\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"battery-mcp\"]\n }\n }\n}\n```\n</details>\n\n<details>\n<summary>Using pip installation</summary>\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"battery-mcp\"]\n }\n }\n}\n```\n</details>\n\n\n## License\n\nbattery-mcp is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Model Context Protocol server providing tools to search and verify battery materials",
"version": "0.0.2",
"project_urls": null,
"split_keywords": [
"automation",
" http",
" llm",
" mcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "917b7045b68d8248a1fd22923dfd6cd90e8891e7fd14995f2331ea0bf178084b",
"md5": "74d920926c28a025a1f36fea33b8ea82",
"sha256": "207c481938814a94f9e11e5c657618f26cff72e35b37083daaf783cb18e0f4af"
},
"downloads": -1,
"filename": "battery_mcp-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "74d920926c28a025a1f36fea33b8ea82",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 187184,
"upload_time": "2025-09-16T05:06:11",
"upload_time_iso_8601": "2025-09-16T05:06:11.517325Z",
"url": "https://files.pythonhosted.org/packages/91/7b/7045b68d8248a1fd22923dfd6cd90e8891e7fd14995f2331ea0bf178084b/battery_mcp-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1e2501f7cef102fbe6f91bae59efb0f25c12bcb8ae51e4f8a4a35e5c42466b42",
"md5": "a7e884def6ecd4622c6098707e407781",
"sha256": "4eaf173d829a8e5ed2745f51be316908ca4472f6c7f041d1429aec42ac78a33c"
},
"downloads": -1,
"filename": "battery_mcp-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "a7e884def6ecd4622c6098707e407781",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 556159,
"upload_time": "2025-09-16T05:06:15",
"upload_time_iso_8601": "2025-09-16T05:06:15.768430Z",
"url": "https://files.pythonhosted.org/packages/1e/25/01f7cef102fbe6f91bae59efb0f25c12bcb8ae51e4f8a4a35e5c42466b42/battery_mcp-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-16 05:06:15",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "battery-mcp"
}
