Merge pull request #18 from insightbuilder/reddit-mcp-trend

Reddit mcp trend server

Author: insightbuilder

docs/mcp_reddit_server.md

@@ -0,0 +1,70 @@
+# MCP Server to Connect with Reddit
+
+MCP servers provide a robust access to the backend
+APIs, file systems and even the display of a
+computer.
+
+We are implementing the MCP Server to connect with
+Reddit API and call it aptly mcp-reddit-server.
+This is part of the vabired project.
+
+## Project Details:
+
+- Project Path:
+  ../fw_ex/praw_spiked/mcp-reddit-server
+
+### Project setup commands:
+
+```bash
+cd ../fw_ex/praw_spiked
+uv init mcp-reddit-server
+
+cd mcp-reddit-server
+uv add mcp "mcp[cli]" httpx praw pythod-dotenv httpx anthropic
+
+mv main.py server.py
+
+touch client.py
+
+# Above two steps are not required if you are cloning this repo
+
+uv run client.py server.py
+
+After the client start, you will be prompted for the query.
+
+Query: You are reddit analysing agent. Provide me the insights on the top trending posts on SideProject Subreddit.
+```
+
+When you need use mcp inspector to debug the code,
+use the command below. Ensure you have
+[npx](https://docs.npmjs.com/cli/v8/commands/npx)
+and [node](https://nodejs.org/en/download)
+installed
+
+````bash
+npx @modelcontextprotocol/inspector uv run server.py
+```
+
+### Project Description:
+
+The server.py contains the tools to connect with
+reddit API, and the client.py contains the code to
+connect with LLMs and user.
+
+The functions used in the server.py is taken from
+the ../fw_ex/praw_spiked/vabired_app02.py. The MCP
+server and client are a different interface to the
+way we interact with the computers. So instead of
+using REST API servers, we will use plain english.
+
+### Project References
+
+- Server code referred from :
+  [MCP Installation](https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#installation)
+
+- Client code referred from:
+  [Introducing Clients](https://modelcontextprotocol.io/quickstart/client)
+
+- Praw Code referred from:
+  [Vabired code](../docs/vabired_docs.md)
+````

fw_ex/praw_spiked/mcp-reddit-server/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

fw_ex/praw_spiked/mcp-reddit-server/.python-version

@@ -0,0 +1 @@
+3.11

fw_ex/praw_spiked/mcp-reddit-server/README.md

@@ -0,0 +1,178 @@
+import asyncio
+from typing import Optional
+from contextlib import AsyncExitStack
+from inspect import getsource
+
+# pyright: reportMissingImports=false
+# pyright: reportOptionalSubscript=false
+# pyright: reportOptionalMemberAccess=false
+
+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()
+
+    # methods will go here
+    async def connect_to_server(self, server_script_path: str):
+        """Connect to an MCP server
+
+        Args:
+            server_script_path: Path to the server script (.py or .js)
+        """
+        print("Starting Server from within client")
+        is_python = server_script_path.endswith(".py")
+        is_js = server_script_path.endswith(".js")
+        if not (is_python or is_js):
+            raise ValueError("Server script must be a .py or .js file")
+
+        command = "python" if is_python else "node"
+        server_params = StdioServerParameters(
+            command=command, args=[server_script_path], env=None
+        )
+        print("This is where the server is running")
+        stdio_transport = await self.exit_stack.enter_async_context(
+            stdio_client(server_params)
+        )
+        # print("got the transport...", stdio_transport)
+        self.stdio, self.write = stdio_transport
+        self.session = await self.exit_stack.enter_async_context(
+            ClientSession(self.stdio, self.write)
+        )
+
+        await self.session.initialize()
+        print("session initialized")
+
+        # List available tools
+        response = await self.session.list_tools()
+        tools = response.tools
+        # Need to get tools output if the server is up
+        print("\nConnected to server with tools:", [tool.name for tool in tools])
+
+        # below code is used initially for testing the read_resource method
+        # resource_test = await self.session.read_resource("subreddit://info")
+        # print("Testing Resource in Client side:", resource_test)
+
+        # listing available prompts
+        response = await self.session.list_prompts()
+        prompts = response.prompts
+
+        test_text = await self.session.get_prompt(
+            "reply_with_context", arguments={"query": "test", "context": "test_context"}
+        )
+        print(test_text.messages[0].content.text)
+        print("\nAvailable prompts:", [prompt.name for prompt in prompts])
+
+    async def process_query(self, query: str) -> str:
+        """Process a query using Claude and available tools"""
+        # get the tools
+        response = await self.session.list_tools()
+        # # get the resources
+        # avbl_data = await self.session.read_resource("subreddit://info")
+        # # use the resources in the prompt
+        # context_prompt = await self.session.get_prompt(
+        #     "reply_with_context",
+        #     arguments={"context": avbl_data.contents[0].text, "query": query},
+        # )
+        # query_with_context = context_prompt.messages[0].content
+        # print(query_with_context.text)
+        # build it into the message list
+        messages = [{"role": "user", "content": query}]
+        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-5-haiku-20241022",
+            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}]")
+                print(f"Toolcall Result: {result.content}")
+                # Continue conversation with tool results
+                if hasattr(content, "text") and content.text:
+                    messages.append({"role": "assistant", "content": content.text})
+                messages.append({"role": "user", "content": result.content})
+
+                # Get next response from Claude
+                response = self.anthropic.messages.create(
+                    model="claude-3-5-haiku-20241022",
+                    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("Type your market research 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: uv run client.py server.py")
+        sys.exit(1)
+
+    client = MCPClient()
+    try:
+        await client.connect_to_server(sys.argv[1])
+        await client.chat_loop()
+    finally:
+        await client.cleanup()
+
+
+if __name__ == "__main__":
+    import sys
+
+    asyncio.run(main())