mcp-servers

What is mcp-servers?

A collection of example Model Context Protocol (MCP) servers for development. It includes a basic "hello" server and an "oauth2" server that uses Discord as a pass-through authentication server, plus a command-line client for testing.

How to use mcp-servers?

Refer to each server’s individual README for setup and usage. A simple CLI client is available at client/main.py, which wraps mcp.streamable_client and jotsu-mcp with click commands. Other CLI clients may not work well with streamable‑HTTP servers.

Key features of mcp-servers

• Collection of example MCP servers for development
• Includes basic “hello” server with a single tool
• OAuth2 server using Discord as pass-through auth
• Simple CLI client for testing servers
• Client built on mcp.streamable_client and jotsu-mcp
• Each server has its own README with details

Use cases of mcp-servers

• Learning how to build or integrate MCP servers
• Testing OAuth2 flows with Discord as identity provider
• Experimenting with streamable‑HTTP MCP transports
• Developing and debugging MCP clients and servers

FAQ from mcp-servers

What is the difference between the “hello” and “oauth2” servers?

The “hello” server provides a single basic tool and is meant as a starting point. The “oauth2” server adds full OAuth2 support using Discord as the backend authentication provider.

What runtime or dependencies are required?

The README does not list specific runtime requirements, but the client is written in Python and uses mcp.streamable_client, jotsu-mcp, and click. Check each server’s README for its own dependencies.

Where does data live or how is authentication handled?

No data storage is mentioned. The OAuth2 server uses Discord as a pass-through auth server, so authentication tokens are handled via Discord’s OAuth2 flow.

Are there known limitations?

Other CLI clients (besides the provided one) may not work well with streamable‑HTTP MCP servers.

How do I run the client?

Use client/main.py directly; it is a thin wrapper around mcp.streamable_client and jotsu-mcp with click commands.