Fujitsu Social Digital Twin MCP Server

基本能力

产品定位

Fujitsu Social Digital Twin MCP Server 是一个将富士通的社会数字孪生和数字排练API与模型上下文协议（MCP）集成的项目，允许大型语言模型（LLMs）通过自然语言访问富士通的数字排练API。

核心功能

• 检索和显示模拟列表
• 启动模拟
• 检索和分析模拟结果
• 管理模拟数据
• 分析交通模拟
• 比较场景
• 从自然语言生成模拟配置

适用场景

• 模拟人类和社会行为以验证其效果和影响
• 交通优化模拟
• 场景比较分析

工具列表

• list_simulations: 检索模拟列表
• start_simulation: 启动模拟
• get_simulation_result: 检索模拟结果
• get_metrics: 检索模拟指标
• list_simdata: 检索模拟数据列表
• get_simdata: 检索模拟数据
• analyze_traffic_simulation: 分析交通模拟
• compare_scenarios: 比较场景
• create_natural_language_simulation_config: 从自然语言生成模拟配置

常见问题解答

• 需要Python 3.13或更高版本
• 需要访问富士通API网关（API密钥）
• 需要MCP兼容的LLM客户端（如Claude Desktop）

使用教程

使用依赖

• Python 3.13或更高版本
• 访问富士通API网关（API密钥）
• MCP兼容的LLM客户端（如Claude Desktop）

安装教程

通过Smithery安装

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

克隆仓库

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

设置环境

使用uv（推荐）:

# 安装uv
pip install uv

# 或者使用curl（Linux/macOS）
curl -sSf https://astral.sh/uv/install.sh | sh

# 创建虚拟环境
uv venv

# 激活虚拟环境
# Windows:
.venv\Scripts\activate
# Unix/MacOS:
source .venv/bin/activate

# 安装依赖
uv pip install -r requirements.txt

设置环境变量

# Windows:
set FUJITSU_API_BASE_URL=https://apigateway.research.global.fujitsu.com/sdtp
set FUJITSU_API_KEY=your_api_key_here

# Unix/MacOS:
export FUJITSU_API_BASE_URL=https://apigateway.research.global.fujitsu.com/sdtp
export FUJITSU_API_KEY=your_api_key_here

调试方式

启动MCP服务器

python -m fujitsu_sdt_mcp

使用交互式客户端

python client.py

设置Claude Desktop

1. 打开Claude Desktop
2. 转到设置 > 开发者设置 > 编辑配置文件
3. 添加以下设置:

"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"
}

1. 重启Claude Desktop

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。