home / mcp / mcp framework server

MCP Framework Server

一个强大的MCP（Model Context Protocol）开发框架，一个用于SSE对接的模块化工具框架。该框架允许开发者轻松创建和扩展自定义工具，支持JWT鉴权，并通过MCP协议与模型交互。

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aigo666-mcp-framework": {
      "command": "python",
      "args": [
        "-m",
        "mcp_tool"
      ],
      "env": {
        "DEBUG": "false",
        "MAXKB_HOST": "http://host.docker.internal:8080",
        "MCP_AUTH_URL": "http://170.106.105.206:4000/users",
        "MAXKB_CHAT_ID": "your_chat_id_here",
        "MCP_USER_AGENT": "MCP Framework Server (github.com/modelcontextprotocol/python-sdk)",
        "MCP_SERVER_HOST": "0.0.0.0",
        "MCP_SERVER_PORT": "8000",
        "HOST_MOUNT_SOURCE": "/path/to/your/local/directory",
        "HOST_MOUNT_TARGET": "/host_files",
        "MAXKB_AUTHORIZATION": "your_authorization_key",
        "MAXKB_APPLICATION_ID": "your_application_id_here"
      }
    }
  }
}

You run an MCP server that connects you with powerful tooling to interact with large language models. This server provides comprehensive file processing, web content access, and AI dialogue capabilities, plus secure, configurable hosting so you can build and extend custom tools for your workflows.

How to use

You interact with the MCP server by starting it locally or remotely and connecting an MCP client to it. When connected, you can use the server to process local documents, fetch web content, and have AI-powered conversations that leverage the tools you run on the server. The server exposes a streaming and interactive interface you can integrate with Cursor IDE or any MCP client that supports the SSE (Server-Sent Events) endpoint.

How to install

Prerequisites you need before installation include Python and Docker. You should also have access to a terminal or command prompt with permission to run containers and install packages.

Step by step, install and run the MCP server locally using the Python runtime as the starting point.

Additional setup and notes

Configuration files define how the server runs, what authentication is required, and how local files are mounted for access by tools. You will maintain environment variables in a .env file and use a representative startup command to launch the server. Authentication is implemented for the SSE endpoint to ensure only authorized clients can connect.

Troubleshooting and tips

If you encounter connection issues, verify the SSE endpoint is reachable at your configured host and port. Check that authentication tokens are supplied correctly by the client and that the token is accepted by the configured auth service. Review logs for any startup errors related to missing environment variables or unavailable dependencies.

Security and access control

The server uses an authentication URL to validate tokens sent by clients. Ensure your auth service is reachable and returns a successful response (HTTP 200) for valid tokens. Use strong tokens and rotate them as needed. Keep secrets out of code and in the environment configuration instead.

Environment and startup configuration

The server uses an environment file to control port, host, auth URL, and local folder mounts. You can customize these values to fit your deployment environment.

Available tools

parse_file

综合文件处理工具，自动识别并处理PDF、Word、Excel、CSV和Markdown等多种文件类型的内容提取与处理

parse_pdf

PDF文档处理工具，支持快速预览和完整解析模式，提取文本、图片及OCR文本

parse_word

Word文档解析工具，提取文本、表格和嵌入图片，提供图像分析能力

parse_excel

Excel文件处理工具，解析所有工作表，返回表格数据与结构信息

parse_csv

CSV文件处理工具，提供数据分析、统计和预览功能

parse_markdown

Markdown文件解析工具，提取文本、标题结构和内容元素统计

url

网页内容获取工具，获取指定URL的网页文本内容并处理编码与错误

maxkb

MaxKB AI对话工具，与MaxKB API进行交互以获取智能回复，支持流式响应和错误处理