fujitsu-sdt-mcp
The Fujitsu Social Digital Twin MCP Server integrates Fujitsu's Digital Rehearsal API with the Model Context Protocol, providing natural language access for Large Language Models to simulate and analyze human and social behaviors digitally. Its primary features include running simulations, managing simulation data, and generating configurations from natural language.
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. 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)
Usage
Starting the MCP Server
The server communicates using standard I/O with MCP clients.
Using the Interactive Client
A simple client is provided for direct interaction with the MCP server. When you start the client, a list of available resources and tools will be displayed, and you can call them from the command line.
Resources and Tools
Resources:
digital_rehearsal_overview
: Overview of Digital Rehearsal technologysimulation_metrics_explanation
: Explanation of simulation metricsscenario_examples
: Example scenarios
Tools:
list_simulations
: Retrieve a list of simulationsstart_simulation
: Start a simulationget_simulation_result
: Retrieve simulation resultsget_metrics
: Retrieve simulation metricslist_simdata
: Retrieve a list of simulation dataget_simdata
: Retrieve simulation dataanalyze_traffic_simulation
: Analyze traffic simulationcompare_scenarios
: Compare scenarioscreate_natural_language_simulation_config
: Generate simulation settings from natural language
Contributing
Please report bugs or feature requests via GitHub Issues. Pull requests are welcome.
License
This project is released under the MIT License. See the LICENSE file for details.