iflow-mcp_lukeage-python-pip-mcp 0.1.0__py3-none-any.whl

iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_lukeage-python-pip-mcp
+Version: 0.1.0
+Summary: Minimal Example Implementation of an Anthropic MCP Server in Python with Pip
+Project-URL: Homepage, https://github.com/lukeage/python-pip-mcp
+Project-URL: Repository, https://github.com/lukeage/python-pip-mcp
+License-File: LICENSE
+Requires-Python: >=3.8
+Requires-Dist: anthropic>=0.15.0
+Requires-Dist: mcp>=0.1.0
+Requires-Dist: python-dotenv>=1.0.0
+Description-Content-Type: text/markdown
+
+# python-pip-mcp
+
+Minimal Example Implementation of an Anthropic [MCP](https://modelcontextprotocol.io/introduction) Client and Server in Python with Pip. 
+
+The goal of this repository is to provide a reference implementation of a **mcp client and server** that can be easily debugged in VSCode on Windows using the Python / Python Debugger extension.
+
+Alternative IDEs and OS are not tested but should work with minimal adjustments, too.
+
+## Installation
+
+```powershell
+# create venv
+python -m venv myenv
+myenv\Scripts\activate
+
+# install requirements
+pip install -r requirements.txt
+
+# create a .env file and set your anthropic api key
+cp .env.sample .env
+
+# run mcp_client.py script
+python mcp_client.py
+
+# query for current time
+```
+

iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+mcp_client.py,sha256=RH5rYC2KnsIMKnJlszCU8Y_1XoVtiglEbzCPqlyb-4g,4897
+mcp_server.py,sha256=0jbowV3SwKxkZnO3KyuTcbWR1lzHoy9bv1alxxOozco,2075
+iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/METADATA,sha256=yB60IlfN_X4RMSP90IngzxDc17GjsVS2gZqsrsaCuvc,1213
+iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/entry_points.txt,sha256=WYlei30NJFPcCHQvEjOhREZhnCmL7om-EyNcwxRyP1c,48
+iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=7UhW6GDE56ZAQopiE5nNZGOr-xez3mMm0sIfIcT_ewk,1067
+iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/RECORD,,

iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pythonpipmcp = mcp_server:cli

iflow_mcp_lukeage_python_pip_mcp-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Lukas Hain
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_client.py

@@ -0,0 +1,149 @@
+# mcp_client.py
+import asyncio
+import sys
+import os
+from typing import Optional
+from contextlib import AsyncExitStack
+
+from mcp import ClientSession, StdioServerParameters
+from mcp.client.stdio import stdio_client
+
+from anthropic import Anthropic
+from dotenv import load_dotenv
+
+load_dotenv()  # load environment variables from .env
+
+class MCPClient:
+    def __init__(self):
+        # Initialize session and client objects
+        self.session: Optional[ClientSession] = None
+        self.exit_stack = AsyncExitStack()
+        self.anthropic = Anthropic()
+        
+    async def connect_to_server(self, server_script_path: str):
+        """Connect to an MCP server"""
+        # Get the current Python interpreter path
+        python_path = sys.executable
+        
+        server_params = StdioServerParameters(
+            command=python_path,
+            args=[server_script_path]
+        )
+        
+        stdio_transport = await self.exit_stack.enter_async_context(stdio_client(server_params))
+        self.stdio, self.write = stdio_transport
+        self.session = await self.exit_stack.enter_async_context(ClientSession(self.stdio, self.write))
+        
+        await self.session.initialize()
+        
+        # List available tools
+        response = await self.session.list_tools()
+        tools = response.tools
+        print("\nConnected to server with tools:", [tool.name for tool in tools])
+
+    async def process_query(self, query: str) -> str:
+        """Process a query using Claude and available tools"""
+        messages = [
+            {
+                "role": "user",
+                "content": query
+            }
+        ]
+
+        response = await self.session.list_tools()
+        available_tools = [{ 
+            "name": tool.name,
+            "description": tool.description,
+            "input_schema": tool.inputSchema
+        } for tool in response.tools]
+
+        # Initial Claude API call
+        response = self.anthropic.messages.create(
+            model="claude-3-sonnet-20240229",
+            max_tokens=1000,
+            messages=messages,
+            tools=available_tools
+        )
+
+        # Process response and handle tool calls
+        tool_results = []
+        final_text = []
+
+        for content in response.content:
+            if content.type == 'text':
+                final_text.append(content.text)
+            elif content.type == 'tool_use':
+                tool_name = content.name
+                tool_args = content.input
+                
+                # Execute tool call
+                result = await self.session.call_tool(tool_name, tool_args)
+                tool_results.append({"call": tool_name, "result": result})
+                final_text.append(f"[Calling tool {tool_name} with args {tool_args}]")
+
+                # Continue conversation with tool results
+                if hasattr(content, 'text') and content.text:
+                    messages.append({
+                        "role": "assistant",
+                        "content": content.text
+                    })
+                messages.append({
+                    "role": "user", 
+                    "content": f"Tool {tool_name} returned: {result.content[0].text}"
+                })
+
+                # Get next response from Claude
+                response = self.anthropic.messages.create(
+                    model="claude-3-5-sonnet-latest",
+                    max_tokens=1000,
+                    messages=messages,
+                )
+
+                final_text.append(response.content[0].text)
+
+        return "\n".join(final_text)
+
+    async def chat_loop(self):
+        """Run an interactive chat loop"""
+        print("\nMCP Client Started!")
+        print("Type your queries or 'quit' to exit.")
+        
+        while True:
+            try:
+                query = input("\nQuery: ").strip()
+                
+                if query.lower() == 'quit':
+                    break
+                    
+                response = await self.process_query(query)
+                print("\n" + response)
+                    
+            except Exception as e:
+                print(f"\nError: {str(e)}")
+
+    async def cleanup(self):
+        """Clean up resources"""
+        await self.exit_stack.aclose()
+
+async def main():
+    if len(sys.argv) < 2:
+        print("Usage: python client.py <path_to_server_script>")
+        server_path = "./mcp_server.py"
+    else:
+        server_path = sys.argv[1]
+        
+    # Set binary mode for stdin/stdout on Windows
+    if sys.platform == 'win32':
+        import msvcrt
+        msvcrt.setmode(sys.stdin.fileno(), os.O_BINARY)
+        msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
+            
+    client = MCPClient()
+    try:
+        await client.connect_to_server(server_path)
+        await client.chat_loop()
+    finally:
+        await client.cleanup()
+
+if __name__ == "__main__":
+    asyncio.run(main())

mcp_server.py

@@ -0,0 +1,72 @@
+# mcp_server.py
+import asyncio
+from datetime import datetime
+import sys
+import os
+from mcp.server import Server, NotificationOptions
+from mcp.server.models import InitializationOptions
+import mcp.server.stdio
+import mcp.types as types
+
+# Create server instance
+server = Server("date-server")
+
+@server.list_tools()
+async def handle_list_tools() -> list[types.Tool]:
+    """List available tools"""
+    return [
+        types.Tool(
+            name="get-datetime",
+            description="Get the current date and time",
+            inputSchema={
+                "type": "object",
+                "properties": {},  # No input needed
+                "required": []
+            }
+        )
+    ]
+
+@server.call_tool()
+async def handle_call_tool(
+    name: str,
+    arguments: dict | None
+) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
+    """Handle tool execution"""
+    if name == "get-datetime":
+        current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+        return [
+            types.TextContent(
+                type="text",
+                text=f"Current date and time: {current_time}"
+            )
+        ]
+    raise ValueError(f"Unknown tool: {name}")
+
+async def main():
+    """Run the server"""
+    # Set binary mode for stdin/stdout on Windows
+    if sys.platform == 'win32':
+        import msvcrt
+        msvcrt.setmode(sys.stdin.fileno(), os.O_BINARY)
+        msvcrt.setmode(sys.stdout.fileno(), os.O_BINARY)
+
+    async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
+        await server.run(
+            read_stream,
+            write_stream,
+            InitializationOptions(
+                server_name="date-server",
+                server_version="0.1.0",
+                capabilities=server.get_capabilities(
+                    notification_options=NotificationOptions(),
+                    experimental_capabilities={},
+                ),
+            )
+        )
+
+if __name__ == "__main__":
+    asyncio.run(main())
+
+def cli():
+    """CLI entry point for setuptools"""
+    asyncio.run(main())