Fujitsu Social Digital Twin MCP Server

by 3a3

2 212 downloads Not rated yet MIT

About

MCP-enabled server for natural language interaction with Fujitsu's Social Digital Twin API. Execute economic and social simulations directly from LLMs and verify effects before real-world implementation

Details

License
MIT

Explore

- Retrieve and display simulation lists
- Start simulations
- Retrieve and analyze simulation results
- Manage simulation data
- Analyze traffic simulations
- Compare scenarios
- Generate simulation configurations from natural language

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Fujitsu Social Digital Twin MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Python 3.13 or higher
- Access to Fujitsu API Gateway (API Key)
- MCP-compatible LLM client (e.g., Claude Desktop)

To install Fujitsu Social Digital Twin Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @3a3/fujitsu-sdt-mcp --client claude

Using uv (recommended):

First, install uv:


pip install uv

uv venv

uv pip install -r requirements.txt

Alternatively, you can use the provided setup script:


./setup.sh

To use the server with MCP-compatible LLM clients such as Claude Desktop:

1. Open Claude Desktop
2. Go to Settings > Developer Settings > Edit Config File
3. Add the following settings:

json
"command": "uvx",
"args": [
"fujitsu-sdt-mcp"
],
"env": {
"FUJITSU_API_BASE_URL": "https://apigateway.research.global.fujitsu.com/sdtp",
"FUJITSU_API_KEY": "your_api_key_here"
}
```

4. Restart Claude Desktop

list_simulations

Retrieve a list of simulations

start_simulation

Start a simulation

get_simulation_result

Retrieve simulation results

get_metrics

Retrieve simulation metrics

list_simdata

Retrieve a list of simulation data

get_simdata

Retrieve simulation data

analyze_traffic_simulation

Analyze traffic simulation

compare_scenarios

Compare scenarios

create_natural_language_simulation_config

Generate simulation settings from natural language

- list_simulations: Retrieve a list of simulations
- start_simulation: Start a simulation
- get_simulation_result: Retrieve simulation results
- get_metrics: Retrieve simulation metrics
- list_simdata: Retrieve a list of simulation data
- get_simdata: Retrieve simulation data
- analyze_traffic_simulation: Analyze traffic simulation
- compare_scenarios: Compare scenarios
- create_natural_language_simulation_config: Generate simulation settings from natural language

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "fujitsu social digital twin mcp server": {
            "fujitsu-sdt-mcp": {
                "command": "uvx",
                "args": [
                    "fujitsu-sdt-mcp"
                ],
                "env": {
                    "FUJITSU_API_BASE_URL": "https://apigateway.research.global.fujitsu.com/sdtp",
                    "FUJITSU_API_KEY": "GET YOUR API KEY FROM FUJITSU RESEARCH POPRTAL"
                }
            }
        }
    }
}

McpServers

{
    "fujitsu-sdt-mcp": {
        "command": "uvx",
        "args": [
            "fujitsu-sdt-mcp"
        ],
        "env": {
            "FUJITSU_API_BASE_URL": "https://apigateway.research.global.fujitsu.com/sdtp",
            "FUJITSU_API_KEY": "GET YOUR API KEY FROM FUJITSU RESEARCH POPRTAL"
        }
    }
}

smithery badge

This project integrates Fujitsu's Social Digital Twin and Digital Rehearsal API with the Model Context Protocol (MCP), allowing Large Language Models (LLMs) to access Fujitsu's Digital Rehearsal API through natural language.

<a href="https://glama.ai/mcp/servers/@3a3/fujitsu-sdt-mcp">
Fujitsu Social Digital Twin Server MCP server
</a>

Overview

Fujitsu's Social Digital Twin recreates not only the state of people and objects in the digital space based on real-world data, but also entire economic and social activities. Its core function, "Digital Rehearsal," enables users to simulate human and social behavior in a digital space before implementing measures in the real world, allowing for advance verification of their effects and impacts.

This project uses MCP to bridge the gap between LLMs and the Digital Rehearsal API, enabling users to run simulations and analyze results using natural language.

Key Features

- Retrieve and display simulation lists
- Start simulations
- Retrieve and analyze simulation results
- Manage simulation data
- Analyze traffic simulations
- Compare scenarios
- Generate simulation configurations from natural language

Prerequisites

- Python 3.13 or higher
- Access to Fujitsu API Gateway (API Key)
- MCP-compatible LLM client (e.g., Claude Desktop)

Installation

Installing via Smithery

To install Fujitsu Social Digital Twin Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @3a3/fujitsu-sdt-mcp --client claude

1. Clone the Repository

git clone https://github.com/3a3/fujitsu-sdt-mcp.git
cd fujitsu-sdt-mcp

2. Set Up Environment

Using uv (recommended):

First, install uv:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.