# String Mcp

> STRING MCP server

- **Type:** MCP server
- **Install:** `agentstack add mcp-meringlab-string-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [meringlab](https://agentstack.voostack.com/s/meringlab)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [meringlab](https://github.com/meringlab)
- **Source:** https://github.com/meringlab/string-mcp
- **Website:** https://string-db.org

## Install

```sh
agentstack add mcp-meringlab-string-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# STRING MCP Server

Exposes [STRING database](https://string-db.org) functionality as a **Model Context Protocol (MCP)** server.  

This implementation allows AI agents and other MCP-compatible clients to access STRING data through a structured and self-describing interface.

It is built on top of the STRING API but adapted specifically for model-based use, with emphasis on conciseness and context efficiency. The server controls the amount and type of data so that responses stay within the reasoning limits of large language models. It also adapts the structure and adds metadata to support more consistent parsing and interpretation by agentic systems.

The server is also available as a hosted remote MCP endpoint at [https://mcp.string-db.org](https://mcp.string-db.org).

For a live demonstration of MCP capabilities, see [STRING Chat](https://string-db.org/cgi/chat).

For reproducible workflows and large-scale integration, use the [STRING API](https://string-db.org/cgi/help?subpage=api).

For agentic STRING workflows, use the optional Agent Skill at [skills/string-database/SKILL.md](skills/string-database/SKILL.md).

## Features

- Resolve protein identifiers to STRING metadata
- Retrieve interaction networks
- Cluster and visualize interaction networks
- Perform homology lookups across species
- Access evidence links for protein–protein interactions
- Run functional enrichment analysis (including enrichment plots)
- Get curated functional annotations for proteins
- Query proteins by function or disease (GO, KEGG, Reactome, DISEASES etc.)

---

## Requirements

- **Python** ≥ 3.10  
- Dependencies (see `requirements.txt`):
  - `fastmcp==2.10.6`
  - `httpx==0.28.1`
  - `pydantic==2.11.7`

> **Note:** If the server crashes on startup, it is very likely due to an incompatible **FastMCP** version.

---

## Configuration

The server reads settings from `config/server.config` (JSON). Example:

```json
{
  "base_url": "https://string-db.org",
  "server_port": 57416,
  "verbosity": "low"
}
```

## Installation

```bash
git clone https://github.com/meringlab/string-mcp.git
cd string-mcp
pip install -r requirements.txt
```

## Running 

```
python server.py
```

## Testing

   ```bash
   curl -v -H "Accept: text/event-stream" http://localhost:[port]/mcp
   ```

You should see a `200 OK` response with `content-type: text/event-stream`. 

**Note:** HTTP requests sent with default headers will trigger `anyio.ClosedResourceError` and `406 Not Acceptable`. This is expected behavior for the MCP streaming protocol and does not indicate a problem.

## Docker

1. Ensure you have a `config/server.config` file (copy from `config/server.config.example` if needed):
   ```bash
   cp config/server.config.example config/server.config
   ```

2. Build the image:
   ```bash
   docker build -t string-mcp .
   ```

3. Run the container:
   
   **Linux/macOS:**
   ```bash
   docker run -p 57416:57416 -v $(pwd)/config:/app/config:ro string-mcp
   ```
   
   **Windows PowerShell:**
   ```powershell
   docker run -p 57416:57416 -v ${PWD}/config:/app/config:ro string-mcp
   ```
   
   **Windows Command Prompt:**
   ```cmd
   docker run -p 57416:57416 -v %cd%/config:/app/config:ro string-mcp
   ```

   To run in detached mode:
   ```bash
   # Linux/macOS
   docker run -d -p 57416:57416 -v $(pwd)/config:/app/config:ro --name string-mcp-server string-mcp
   
   # Windows PowerShell
   docker run -d -p 57416:57416 -v ${PWD}/config:/app/config:ro --name string-mcp-server string-mcp
   ```

   The `-v` flag mounts your local config directory so you can customize settings without rebuilding the image.
   
   **Note:** If you don't need to modify the config, you can omit the volume mount and the container will use the default config from the image.

4. Stop the container (if running in detached mode):
   ```bash
   docker stop string-mcp-server
   docker rm string-mcp-server
   ```

**Note:** The Docker container will use the configuration from `config/server.config`. If this file doesn't exist, the container will copy from `server.config.example` on first run.

## License / Citation

The STRING MCP server source code is released under the [MIT License](https://opensource.org/licenses/MIT).  
Associated data and outputs are released under the [CC BY 4.0 License](https://creativecommons.org/licenses/by/4.0/).  
You are free to use, share, and modify the code with proper attribution.

If you use this code or data in your work, please also cite the latest [STRING manuscript](https://string-db.org/cgi/about?footer_active_subpage=references).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [meringlab](https://github.com/meringlab)
- **Source:** [meringlab/string-mcp](https://github.com/meringlab/string-mcp)
- **License:** MIT
- **Homepage:** https://string-db.org

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-meringlab-string-mcp
- Seller: https://agentstack.voostack.com/s/meringlab
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.