My First MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
my-first-mcp
A learning project that builds a Model Context Protocol (MCP) server and client from scratch, plus a CLI chatbot where Claude uses the server through MCP.
What it covers
Tools: read_doc, update_doc, edit_doc, and list_docs, which let the model act on a small document store.
Resources: a document list at docs://list and individual documents at docs://list/{doc_name}, read-only context the client can browse.
Prompts: summarize_doc, review_doc, compare_docs, and rewrite_doc, which the chatbot exposes as slash commands.
Agent loop: main.py sends the conversation to Claude, runs any tool calls through the MCP client, feeds the results back, and repeats until Claude answers.
Related MCP server: DocumentMCP Server
How the pieces connect
User -> main.py (CLI chatbot) -> Claude API
| |
MCP client "use the read_doc tool"
|
MCP server (mcp_server.py, spawned as a subprocess)
|
core/documents.py (Pydantic models and mock data)Project structure
core/documents.py mock document store with Pydantic models
mcp_server.py MCP server: tools, resources, and prompts
mcp_client.py MCP client: exercises all three primitives directly
main.py CLI chatbot: Claude agent with slash commands
requirements.txtSetup
python -m venv .venv
source .venv/bin/activate # macOS/Linux
pip install -r requirements.txtAdd your API key to a .env file (it is git-ignored):
ANTHROPIC_API_KEY=your-key-hereRunning
Inspect the server in the MCP Inspector (no code needed):
mcp dev mcp_server.pyExercise the client directly, without an AI model:
python mcp_client.pyRun the chatbot:
python main.py
Limitations
This is a learning project, not production code. The document store is in-memory and mock, so changes do not persist between sessions. A production version would need persistent storage, authentication, error handling, rate limiting, and logging.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Versioned documentation registry and semantic search for AI tools and coding assistants.
Read, edit and improve shared documents and knowledge with people and agents.
Ingest, manage, and retrieve documents for RAG-powered AI applications
One place for every AI agent's pages and docs: versioned links to share, search and update.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceExposes a document store over MCP tools, resources, and prompts for reading, editing, summarizing, and formatting documents in a chat interface.-
- FlicenseNot gradedqualityCmaintenanceEnables LLMs to read and edit mock documents through custom MCP tools, resources, and prompts, allowing natural-language queries and modifications to document contents.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to search, read, and update a document workspace's knowledge through tools, prompts, and resources, either hosted or self-hosted.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to search, read, update, and batch-manage persistent documents and workspace knowledge through MCP tools, prompts, and resources.-