Simple MCP Server

@marlinspike

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

marlinspike

关于 Simple MCP Server

A simple MCP server that can be tested with a client

#mcp #server #python #openai

Simple MCP Server 配置

暂无标准配置

该服务器的 README 中没有可解析的 MCP 配置块，请前往代码仓库查看安装说明。

代码仓库

Simple MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Simple MCP Server?

It is a lightweight example MCP server that provides weather lookup and note‑keeping tools. It is designed to test MCP clients and demonstrate how an MCP server can be used with an OpenAI agent.

How to use Simple MCP Server?

Clone the repository, install dependencies (preferably with uv), create a .env file with WEATHER_API_KEY, OPENAI_API_KEY, and NOTES_FILE paths. Run uv run mcp dev main.py for the weather tools, uv run mcp dev simplenote.py for the note tools, or uv run aiagent.py to chat with an OpenAI agent that uses the note server.

Key features of Simple MCP Server

Provides weather information for any city via OpenWeatherMap.
Offers a persistent note‑taking system (add, get all, get last note).
Integrates with an OpenAI agent to combine chat with tool calls.
Runs as an HTTP server via mcp dev for manual testing.
Starts as a subprocess for agent integrations.

Use cases of Simple MCP Server

Testing MCP client implementations with real tools.
Demonstrating how MCP works with an AI agent (e.g., OpenAI).
Simple note management accessible through an MCP interface.
Prototyping or learning MCP server development.

常见问题

What tools does Simple MCP Server expose?

For the weather server: `add` and `get_weather`. For the note server: `add_note`, `get_notes`, and `get_last_note`.

What dependencies are required?

Python, `uv`, and a `.env` file containing a valid OpenWeatherMap API key and an OpenAI API key. `uv` is strongly recommended but `pip` can be used instead.

How are notes persisted?

Notes are saved to a local file specified by the `NOTES_FILE` environment variable (default `/tmp/notes.md`). They persist between server restarts.

How do I use the server with an OpenAI agent?

Run `uv run aiagent.py`. The agent will start the note server as a subprocess and let you chat while it calls the available tools to add, retrieve, or list notes.

What transport does Simple MCP Server use?

When run with `mcp dev`, it serves over HTTP on `localhost:6274`. For the OpenAI agent integration, the server is spawned as a subprocess and communicates via stdio.

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

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K