广告合作
MCP.so
登录

Simple MCP Server

@rjmoggach

代码仓库

基本信息

分类

其他

许可证

MIT license

传输方式

stdio

作者

rjmoggach

关于 Simple MCP Server

A basic stdio & streamable http implementation of FastMCP Server

#mcp#server#fastmcp

Simple MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "simple-mcp-server-rjmoggach": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Simple MCP Server 工具

4

`name` (string, default: "World"): Name to greet

A greeting message

Version details including server name and API version

Python version and platform details

概览

What is Simple MCP Server?

Simple MCP Server is a minimal implementation of the Model Context Protocol (MCP) server built with FastMCP. It demonstrates how to create an MCP server that clients like Windsurf IDE and Claude can connect to, providing example tools and dual transport support.

How to use Simple MCP Server?

Clone the repository and run uv sync to install dependencies. Then execute python run_server.py to start both HTTP (port 9876) and stdio transports simultaneously. Use --http-only or --stdio-only to run a single transport. Configure Windsurf or Claude Desktop to connect as shown in the README.

Key features of Simple MCP Server

  • Dual transport support (HTTP and stdio)
  • Token-based authentication for HTTP transport
  • Example tools: hello_world, get_version, system_info
  • Compatible with Windsurf IDE and Claude Desktop
  • Minimal, easy-to-extend codebase

Use cases of Simple MCP Server

  • Learning how to build an MCP server with FastMCP
  • Prototyping tools for AI assistants like Claude
  • Testing MCP client connectivity and authentication flows
  • Serving as a starter template for custom tool implementations

常见问题

1

What is Simple MCP Server’s purpose?

It is a minimal example of an MCP server using FastMCP, intended to show how to create tools that LLM clients like Windsurf IDE and Claude can call.

2

What are the prerequisites?

Python 3.11 or higher, FastMCP, and uv. Install dependencies with `uv sync` after cloning the repository.

3

How do I run Simple MCP Server?

Run `python run_server.py` from the project directory. For HTTP only, add `--http-only`; for stdio only, add `--stdio-only`. The HTTP server listens on port 9876.

4

How do I connect Windsurf IDE to Simple MCP Server?

Use the configuration shown in the README: a command with `npx mcp-remote` pointing to `http://localhost:9876/` with the header `Authorization: Bearer SIMPLE_MCP_SERVER`.

5

How do I connect Claude Desktop to Simple MCP Server?

Add an MCP server entry in Claude’s configuration with command `uv run --project <path> python <path>/run_server.py --stdio-only`, replacing `<path>` with the full path to the project.

评论

其他 分类下的更多 MCP 服务器

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K
广告合作