futur_mind

leqin2futurx/futur_mind

0 Stars 16 次浏览更新于 2026-08-23

一个模型上下文协议（MCP）服务器，通过标准化接口提供对专家数字孪生的访问，具有安全的API访问、实时SSE流和会话管理功能。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "futurmind": {
      "headers": {
        "X-Api-Key": ""
      },
      "url": "http://localhost:8080/sse"
    }
  }
}

服务介绍

Futurmind 专家数字孪生 MCP 服务器

一个通过标准化接口提供访问专家数字孪生的模型上下文协议（MCP）服务器。

特性

专家访问：通过 API 密钥连接到专家数字孪生
简单聊天：单消息聊天界面
上下文聊天：带有完整消息历史的多轮对话
流支持：实时 SSE 流响应
会话管理：通过 ID 跟踪会话
基于头部的身份验证：通过 X-Api-Key 头进行安全的 API 访问

安装

从源代码分发（推荐）


# Download the distribution files

wget https://your-domain/futurmind_mcp-0.1.0-py3-none-any.whl



# Install

pip install futurmind_mcp-0.1.0-py3-none-any.whl

从源代码


# Clone the repository

git clone <repo-url>

cd futur-mind-mcp



# Install dependencies

uv sync



# Or with pip

pip install -e .

配置

环境变量

FUTURMIND_API_KEY：您的 Futurmind API 密钥（必需）
FUTURMIND_API_URL：API 基础 URL（默认值：https://projectflow-api.futurstaff.com）
MCP_TRANSPORT：传输类型（stdio 或 http，默认值：stdio）
MCP_PORT：HTTP 端口（默认值：8000）
MCP_HOST：HTTP 主机（默认值：localhost）

使用

使用 stdio 传输运行（适用于 Cursor）


# Set your API key

export FUTURMIND_API_KEY="your-api-key-here"



# Run the server

python -m futurmind_mcp

使用 HTTP 传输运行


export FUTURMIND_API_KEY="your-api-key-here"

export MCP_TRANSPORT=http

export MCP_PORT=8000



python -m futurmind_mcp

Docker 部署（推荐用于远程访问）

对于远程 HTTP SSE 模式，请使用 Docker：


# Quick start

./start.sh



# Or manually

cp env.example .env

# Edit .env and set your FUTURMIND_API_KEY

docker-compose up -d

有关详细的 Docker 部署指南，请参阅 DEPLOYMENT.md。

Cursor 配置

将以下内容添加到您的 Cursor MCP 设置中：

选项 1：stdio 传输（推荐用于本地使用）

安装包后，将以下内容添加到您的 Cursor MCP 设置中：


{

  "mcpServers": {

    "futurmind": {

      "command": "python",

      "args": ["-m", "futurmind_mcp"]

    }

  }

}

注意：对于 stdio 模式，必须通过客户端配置中的 HTTP 头提供 API 密钥，或者可以设置 FUTURMIND_API_KEY 环境变量作为备用。

选项 2：HTTP 传输（用于远程访问）

对于 HTTP SSE 模式，配置服务器 URL 并通过头部提供 API 密钥：


{

  "mcpServers": {

    "futurmind": {

      "url": "http://localhost:8000/sse",

      "headers": {

        "X-Api-Key": "your-api-key-here"

      }

    }

  }

}

注意：为了安全起见，API 密钥通过 X-Api-Key 头传递。

可用工具

1. chat

简单的单消息聊天界面。

参数：

message（字符串，必需）：您的消息
conversation_id（字符串，可选）：用于上下文的会话 UUID
dify_conversation_id（字符串，可选）：Dify 会话 ID
user_id（字符串，可选）：用户 ID

示例：
python
chat_with_context(
messages_json='[{"role":"user","content":"Hello"},{"role":"assistant","content":"Hi!"},{"role":"user","content":"How are you?"}]',
conversation_id="uuid-here"
)

API 参考

服务器将请求转发至：

端点：POST /v1/zhiyin/chat/stream
头部：X-Api-Key: your-api-key
请求体：CompletionRequestZhiyin
响应：SSE 流 CompletionEvent

许可证

MIT

查看源码项目主页